From 48e9b7594a893118edc1ef3bb36e1ea8e5fa38d9 Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Thu, 3 Nov 2016 18:20:10 +0100 Subject: [PATCH 01/26] Doxygen: identify all files lacking a @file comment MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit reason is, only files with a @file comment will be processed with further documentation commands. For this reason, our Doxygen documentation is lacking a lot of entries. HOWTO: find src -type f \( -name '*.cpp' -or -name '*.hpp' \) -not -exec egrep -q '\*.+@file' {} \; -print -exec sed -i -r -e'\_\*/_,$ { 1,+0 a\ \ \ /** @file §§§\ ** TODO §§§\ */ }' {} \; --- src/backend/engine/engine-config.cpp | 5 +++++ src/backend/engine/scheduler-frontend.cpp | 5 +++++ src/backend/engine/scheduler-frontend.hpp | 5 +++++ src/backend/enginefacade.cpp | 5 +++++ src/backend/enginefacade.hpp | 5 +++++ src/backend/media-access-facade.cpp | 5 +++++ src/backend/media-access-facade.hpp | 5 +++++ src/backend/netnodefacade.cpp | 5 +++++ src/backend/netnodefacade.hpp | 5 +++++ src/backend/real-clock.cpp | 5 +++++ src/backend/scriptrunnerfacade.cpp | 5 +++++ src/backend/scriptrunnerfacade.hpp | 5 +++++ src/backend/thread-wrapper.hpp | 5 +++++ src/backend/threadpool-init.cpp | 5 +++++ src/common/advice/binding.cpp | 5 +++++ src/common/appstate.cpp | 5 +++++ src/common/basic-setup.cpp | 5 +++++ src/common/basic-setup.hpp | 5 +++++ src/common/configfacade.cpp | 5 +++++ src/common/guifacade.cpp | 5 +++++ src/common/interfaceproxy.cpp | 5 +++++ src/common/option.cpp | 5 +++++ src/common/option.hpp | 5 +++++ src/common/query/config-rules.cpp | 5 +++++ src/common/query/defs-manager.hpp | 5 +++++ src/common/query/query-resolver.cpp | 5 +++++ src/common/query/query-resolver.hpp | 5 +++++ src/common/subsys.cpp | 5 +++++ src/common/subsystem-runner.hpp | 5 +++++ src/gui/ctrl/playback-controller.cpp | 5 +++++ src/gui/dialog/dialog.hpp | 5 +++++ src/gui/dialog/name-chooser.cpp | 5 +++++ src/gui/dialog/name-chooser.hpp | 5 +++++ src/gui/dialog/preferences-dialog.hpp | 5 +++++ src/gui/dialog/render.cpp | 5 +++++ src/gui/display-service.cpp | 5 +++++ src/gui/gtk-lumiera.cpp | 5 +++++ src/gui/model/clip-track.cpp | 5 +++++ src/gui/model/clip.cpp | 5 +++++ src/gui/model/group-track.cpp | 5 +++++ src/gui/model/parent-track.cpp | 5 +++++ src/gui/model/project.cpp | 5 +++++ src/gui/model/sequence.cpp | 5 +++++ src/gui/model/track.cpp | 5 +++++ src/gui/notification-service.cpp | 5 +++++ src/gui/output/displayer.cpp | 5 +++++ src/gui/output/gdkdisplayer.cpp | 5 +++++ src/gui/output/xvdisplayer.cpp | 5 +++++ src/gui/panel/assets-panel.cpp | 5 +++++ src/gui/panel/assets-panel.hpp | 5 +++++ src/gui/panel/panel.cpp | 5 +++++ src/gui/panel/panel.hpp | 5 +++++ src/gui/panel/timeline-panel.cpp | 5 +++++ src/gui/panel/viewer-panel.cpp | 5 +++++ src/gui/ui-bus.cpp | 5 +++++ src/gui/util/cairo-util.cpp | 5 +++++ src/gui/util/cairo-util.hpp | 5 +++++ src/gui/util/rectangle.cpp | 5 +++++ src/gui/util/rectangle.hpp | 5 +++++ src/gui/widget/button-bar.cpp | 5 +++++ src/gui/widget/button-bar.hpp | 5 +++++ src/gui/widget/menu-button.cpp | 5 +++++ src/gui/widget/menu-button.hpp | 5 +++++ src/gui/widget/mini-button.hpp | 5 +++++ src/gui/widget/panel-bar.cpp | 5 +++++ src/gui/widget/timecode-widget.cpp | 5 +++++ src/gui/widget/timecode-widget.hpp | 5 +++++ src/gui/widget/timeline-widget.cpp | 5 +++++ src/gui/widget/timeline/basic-draw-strategy.hpp | 5 +++++ src/gui/widget/timeline/draw-strategy.cpp | 5 +++++ src/gui/widget/timeline/draw-strategy.hpp | 5 +++++ src/gui/widget/timeline/timeline-arrow-tool.cpp | 5 +++++ src/gui/widget/timeline/timeline-body.cpp | 5 +++++ src/gui/widget/timeline/timeline-clip-track.cpp | 5 +++++ src/gui/widget/timeline/timeline-clip.cpp | 5 +++++ src/gui/widget/timeline/timeline-entity.cpp | 5 +++++ src/gui/widget/timeline/timeline-group-track.cpp | 5 +++++ src/gui/widget/timeline/timeline-group-track.hpp | 5 +++++ src/gui/widget/timeline/timeline-header-container.cpp | 5 +++++ src/gui/widget/timeline/timeline-header-container.hpp | 5 +++++ src/gui/widget/timeline/timeline-header-widget.cpp | 5 +++++ src/gui/widget/timeline/timeline-header-widget.hpp | 5 +++++ src/gui/widget/timeline/timeline-ibeam-tool.cpp | 5 +++++ src/gui/widget/timeline/timeline-layout-helper.cpp | 5 +++++ src/gui/widget/timeline/timeline-ruler.cpp | 5 +++++ src/gui/widget/timeline/timeline-ruler.hpp | 5 +++++ src/gui/widget/timeline/timeline-state.cpp | 5 +++++ src/gui/widget/timeline/timeline-state.hpp | 5 +++++ src/gui/widget/timeline/timeline-tool.cpp | 5 +++++ src/gui/widget/timeline/timeline-tool.hpp | 5 +++++ src/gui/widget/timeline/timeline-track.cpp | 5 +++++ src/gui/widget/timeline/timeline-track.hpp | 5 +++++ src/gui/widget/timeline/timeline-view-window.cpp | 5 +++++ src/gui/widget/timeline/timeline-view-window.hpp | 5 +++++ src/gui/widget/timeline/timeline-zoom-scale.cpp | 5 +++++ src/gui/widget/timeline/timeline-zoom-scale.hpp | 5 +++++ src/gui/widget/video-display-widget.cpp | 5 +++++ src/gui/widget/video-display-widget.hpp | 5 +++++ src/gui/window-manager.cpp | 5 +++++ src/gui/workspace/actions.cpp | 5 +++++ src/gui/workspace/panel-manager.cpp | 5 +++++ src/gui/workspace/workspace-window.cpp | 5 +++++ src/lib/allocation-cluster.cpp | 5 +++++ src/lib/bool-checkable.hpp | 5 +++++ src/lib/cmdline.cpp | 5 +++++ src/lib/cmdline.hpp | 5 +++++ src/lib/dependency-factory.hpp | 5 +++++ src/lib/frameid.hpp | 5 +++++ src/lib/idi/genfunc.cpp | 5 +++++ src/lib/lifecycle.cpp | 5 +++++ src/lib/meta/maybe-compare.hpp | 5 +++++ src/lib/meta/no-instance.hpp | 5 +++++ src/lib/meta/size-trait.hpp | 5 +++++ src/lib/meta/trait-special.hpp | 5 +++++ src/lib/nobug-init.cpp | 5 +++++ src/lib/nocopy.hpp | 5 +++++ src/lib/optional-ref.hpp | 5 +++++ src/lib/query-diagnostics.hpp | 5 +++++ src/lib/query-text.cpp | 5 +++++ src/lib/query-util.cpp | 5 +++++ src/lib/query-util.hpp | 5 +++++ src/lib/ref-array.hpp | 5 +++++ src/lib/scoped-holder-transfer.hpp | 5 +++++ src/lib/searchpath.cpp | 5 +++++ src/lib/searchpath.hpp | 5 +++++ src/lib/test/depend-4test.hpp | 5 +++++ src/lib/test/event-log.cpp | 5 +++++ src/lib/test/suite.cpp | 5 +++++ src/lib/test/test-coll.hpp | 5 +++++ src/lib/test/testdummy.hpp | 5 +++++ src/lib/test/testoption.cpp | 5 +++++ src/lib/test/testoption.hpp | 5 +++++ src/lib/time/formats.hpp | 5 +++++ src/lib/time/grid.hpp | 5 +++++ src/lib/time/quantiser.cpp | 5 +++++ src/lib/time/quantiser.hpp | 5 +++++ src/lib/time/timecode.cpp | 5 +++++ src/lib/time/timecode.hpp | 5 +++++ src/lib/time/timequant.hpp | 5 +++++ src/lib/util-quant.hpp | 5 +++++ src/lib/util.cpp | 5 +++++ src/lib/util.hpp | 5 +++++ src/lib/visitor-dispatcher.hpp | 5 +++++ src/lib/wrapperptr.hpp | 5 +++++ src/lumiera/main.cpp | 5 +++++ src/proc/asset.cpp | 5 +++++ src/proc/asset/category.cpp | 5 +++++ src/proc/asset/category.hpp | 5 +++++ src/proc/asset/clip.cpp | 5 +++++ src/proc/asset/clip.hpp | 5 +++++ src/proc/asset/codec.cpp | 5 +++++ src/proc/asset/codec.hpp | 5 +++++ src/proc/asset/compoundmedia.cpp | 5 +++++ src/proc/asset/compoundmedia.hpp | 5 +++++ src/proc/asset/dataset.hpp | 5 +++++ src/proc/asset/db.hpp | 5 +++++ src/proc/asset/effect.cpp | 5 +++++ src/proc/asset/effect.hpp | 5 +++++ src/proc/asset/inventory.hpp | 5 +++++ src/proc/asset/media.cpp | 5 +++++ src/proc/asset/meta.cpp | 5 +++++ src/proc/asset/meta/time-grid.cpp | 5 +++++ src/proc/asset/pipe.cpp | 5 +++++ src/proc/asset/pipe.hpp | 5 +++++ src/proc/asset/preview.cpp | 5 +++++ src/proc/asset/preview.hpp | 5 +++++ src/proc/asset/proc.cpp | 5 +++++ src/proc/asset/procpatt.cpp | 5 +++++ src/proc/asset/procpatt.hpp | 5 +++++ src/proc/asset/sequence.cpp | 5 +++++ src/proc/asset/struct.cpp | 5 +++++ src/proc/asset/timeline.cpp | 5 +++++ src/proc/asset/typed-lookup.cpp | 5 +++++ src/proc/asset/unknown.cpp | 5 +++++ src/proc/asset/unknown.hpp | 5 +++++ src/proc/asset/viewer.cpp | 5 +++++ src/proc/assetmanager.cpp | 5 +++++ src/proc/config-resolver.cpp | 5 +++++ src/proc/control/argument-erasure.hpp | 5 +++++ src/proc/control/handling-pattern.cpp | 5 +++++ src/proc/control/mediaimpllib.hpp | 5 +++++ src/proc/control/pathmanager.cpp | 5 +++++ src/proc/control/pathmanager.hpp | 5 +++++ src/proc/control/proc-dispatcher.cpp | 5 +++++ src/proc/control/stypemanager.cpp | 5 +++++ src/proc/control/stypemanager.hpp | 5 +++++ src/proc/controllerfacade.cpp | 5 +++++ src/proc/controllerfacade.hpp | 5 +++++ src/proc/engine/buffer-local-key.hpp | 5 +++++ src/proc/engine/buffer-provider.cpp | 5 +++++ src/proc/engine/bufftable-obsolete.hpp | 5 +++++ src/proc/engine/bufftable.hpp | 5 +++++ src/proc/engine/calc-plan-continuation.cpp | 5 +++++ src/proc/engine/calc-plan-continuation.hpp | 5 +++++ src/proc/engine/calc-stream.hpp | 5 +++++ src/proc/engine/diagnostic-buffer-provider.cpp | 5 +++++ src/proc/engine/dispatch-table.cpp | 5 +++++ src/proc/engine/dispatch-table.hpp | 5 +++++ src/proc/engine/dispatcher.cpp | 5 +++++ src/proc/engine/dispatcher.hpp | 5 +++++ src/proc/engine/engine-service-mock.cpp | 5 +++++ src/proc/engine/engine-service.cpp | 5 +++++ src/proc/engine/frame-coord.hpp | 5 +++++ src/proc/engine/job-ticket.hpp | 5 +++++ src/proc/engine/link.cpp | 5 +++++ src/proc/engine/link.hpp | 5 +++++ src/proc/engine/mask.cpp | 5 +++++ src/proc/engine/mask.hpp | 5 +++++ src/proc/engine/nodefactory.cpp | 5 +++++ src/proc/engine/nodefactory.hpp | 5 +++++ src/proc/engine/nodewiring.cpp | 5 +++++ src/proc/engine/nodewiring.hpp | 5 +++++ src/proc/engine/pluginadapter.cpp | 5 +++++ src/proc/engine/pluginadapter.hpp | 5 +++++ src/proc/engine/render-invocation.cpp | 5 +++++ src/proc/engine/renderengine.cpp | 5 +++++ src/proc/engine/renderengine.hpp | 5 +++++ src/proc/engine/rendergraph.cpp | 5 +++++ src/proc/engine/rendergraph.hpp | 5 +++++ src/proc/engine/source.cpp | 5 +++++ src/proc/engine/source.hpp | 5 +++++ src/proc/engine/stateproxy.cpp | 5 +++++ src/proc/engine/stateproxy.hpp | 5 +++++ src/proc/engine/time-anchor.hpp | 5 +++++ src/proc/engine/tracking-heap-block-provider.cpp | 5 +++++ src/proc/engine/worker/dummy-image-generator.cpp | 5 +++++ src/proc/external/libgavl.cpp | 5 +++++ src/proc/external/libgavl.hpp | 5 +++++ src/proc/facade.cpp | 5 +++++ src/proc/mobject/builder/assembler.cpp | 5 +++++ src/proc/mobject/builder/assembler.hpp | 5 +++++ src/proc/mobject/builder/common.hpp | 5 +++++ src/proc/mobject/builder/conmanager.cpp | 5 +++++ src/proc/mobject/builder/conmanager.hpp | 5 +++++ src/proc/mobject/builder/mould.hpp | 5 +++++ src/proc/mobject/builder/nodecreatortool.cpp | 5 +++++ src/proc/mobject/builder/nodecreatortool.hpp | 5 +++++ src/proc/mobject/builder/operationpoint.cpp | 5 +++++ src/proc/mobject/builder/operationpoint.hpp | 5 +++++ src/proc/mobject/builder/renderstate.hpp | 5 +++++ src/proc/mobject/builder/segmentation-tool.cpp | 5 +++++ src/proc/mobject/builder/segmentation-tool.hpp | 5 +++++ src/proc/mobject/builder/toolfactory.cpp | 5 +++++ src/proc/mobject/builder/toolfactory.hpp | 5 +++++ src/proc/mobject/builder/wiringrequest.hpp | 5 +++++ src/proc/mobject/builderfacade.cpp | 5 +++++ src/proc/mobject/builderfacade.hpp | 5 +++++ src/proc/mobject/explicitplacement.hpp | 5 +++++ src/proc/mobject/interpolator.cpp | 5 +++++ src/proc/mobject/interpolator.hpp | 5 +++++ src/proc/mobject/mobject.cpp | 5 +++++ src/proc/mobject/mobject.hpp | 5 +++++ src/proc/mobject/output-designation.hpp | 5 +++++ src/proc/mobject/parameter.cpp | 5 +++++ src/proc/mobject/parameter.hpp | 5 +++++ src/proc/mobject/paramprovider.cpp | 5 +++++ src/proc/mobject/paramprovider.hpp | 5 +++++ src/proc/mobject/placement.cpp | 5 +++++ src/proc/mobject/session/abstractmo.cpp | 5 +++++ src/proc/mobject/session/abstractmo.hpp | 5 +++++ src/proc/mobject/session/allocation.cpp | 5 +++++ src/proc/mobject/session/allocation.hpp | 5 +++++ src/proc/mobject/session/auto.cpp | 5 +++++ src/proc/mobject/session/auto.hpp | 5 +++++ src/proc/mobject/session/binding.cpp | 5 +++++ src/proc/mobject/session/binding.hpp | 5 +++++ src/proc/mobject/session/bus-mo.cpp | 5 +++++ src/proc/mobject/session/bus-mo.hpp | 5 +++++ src/proc/mobject/session/clip.cpp | 5 +++++ src/proc/mobject/session/clip.hpp | 5 +++++ src/proc/mobject/session/constraint.cpp | 5 +++++ src/proc/mobject/session/constraint.hpp | 5 +++++ src/proc/mobject/session/effect.cpp | 5 +++++ src/proc/mobject/session/effect.hpp | 5 +++++ src/proc/mobject/session/element-query.hpp | 5 +++++ src/proc/mobject/session/fixedlocation.cpp | 5 +++++ src/proc/mobject/session/fixedlocation.hpp | 5 +++++ src/proc/mobject/session/fixture.cpp | 5 +++++ src/proc/mobject/session/fixture.hpp | 5 +++++ src/proc/mobject/session/fork.cpp | 5 +++++ src/proc/mobject/session/fork.hpp | 5 +++++ src/proc/mobject/session/generator-mo.cpp | 5 +++++ src/proc/mobject/session/generator-mo.hpp | 5 +++++ src/proc/mobject/session/label.cpp | 5 +++++ src/proc/mobject/session/label.hpp | 5 +++++ src/proc/mobject/session/locatingpin.cpp | 5 +++++ src/proc/mobject/session/meta.cpp | 5 +++++ src/proc/mobject/session/meta.hpp | 5 +++++ src/proc/mobject/session/mobjectfactory.cpp | 5 +++++ src/proc/mobject/session/mobjectfactory.hpp | 5 +++++ src/proc/mobject/session/placement-index-query-resolver.cpp | 5 +++++ src/proc/mobject/session/plug.cpp | 5 +++++ src/proc/mobject/session/plug.hpp | 5 +++++ src/proc/mobject/session/query-focus-stack.hpp | 5 +++++ src/proc/mobject/session/query-focus.cpp | 5 +++++ src/proc/mobject/session/query-focus.hpp | 5 +++++ src/proc/mobject/session/query/fake-configrules.cpp | 5 +++++ src/proc/mobject/session/relativelocation.cpp | 5 +++++ src/proc/mobject/session/relativelocation.hpp | 5 +++++ src/proc/mobject/session/root.cpp | 5 +++++ src/proc/mobject/session/root.hpp | 5 +++++ src/proc/mobject/session/scope-locator.hpp | 5 +++++ src/proc/mobject/session/scope-path.cpp | 5 +++++ src/proc/mobject/session/scope.hpp | 5 +++++ src/proc/mobject/session/segment.cpp | 5 +++++ src/proc/mobject/session/segment.hpp | 5 +++++ src/proc/mobject/session/segmentation.cpp | 5 +++++ src/proc/mobject/session/segmentation.hpp | 5 +++++ src/proc/mobject/session/sess-manager-impl.hpp | 5 +++++ src/proc/mobject/session/session-impl.cpp | 5 +++++ src/proc/mobject/session/session-services.cpp | 5 +++++ src/proc/mobject/session/specific-contents-query.hpp | 5 +++++ src/proc/mobject/session/wish.cpp | 5 +++++ src/proc/mobject/session/wish.hpp | 5 +++++ src/proc/play/dummy-play-connection.cpp | 5 +++++ src/proc/play/dummy-player-service.cpp | 5 +++++ src/proc/play/output-director.cpp | 5 +++++ src/proc/play/output-slot.cpp | 5 +++++ src/proc/play/play-process.cpp | 5 +++++ src/proc/play/play-service.cpp | 5 +++++ src/proc/play/render-configurator.cpp | 5 +++++ src/proc/play/sound/jack-output.cpp | 5 +++++ src/proc/play/timings.cpp | 5 +++++ src/proc/state.cpp | 5 +++++ src/proc/state.hpp | 5 +++++ src/proc/streamtype.cpp | 5 +++++ tests/backend/sync-classlock-test.cpp | 4 ++++ tests/backend/sync-locking-test.cpp | 4 ++++ tests/backend/sync-timedwait-test.cpp | 4 ++++ tests/backend/sync-waiting-test.cpp | 4 ++++ tests/backend/thread-local-test.cpp | 4 ++++ tests/backend/thread-wrapper-join-test.cpp | 4 ++++ tests/backend/thread-wrapper-test.cpp | 4 ++++ tests/basics/diagnostic-context-test.cpp | 4 ++++ tests/basics/streamtypebasicstest.cpp | 4 ++++ tests/basics/streamtypelifecycletest.cpp | 4 ++++ tests/basics/teststreamtypes.hpp | 4 ++++ tests/basics/time/digxel-configurations-test.cpp | 4 ++++ tests/basics/time/digxel-test.cpp | 4 ++++ tests/basics/time/format-support-test.cpp | 4 ++++ tests/basics/time/quantiser-basics-test.cpp | 4 ++++ tests/basics/time/time-basics-test.cpp | 4 ++++ tests/basics/time/time-control-test.cpp | 4 ++++ tests/basics/time/time-formats-test.cpp | 4 ++++ tests/basics/time/time-mutation-test.cpp | 4 ++++ tests/basics/time/time-parsing-test.cpp | 4 ++++ tests/basics/time/time-quantisation-test.cpp | 4 ++++ tests/basics/time/time-value-test.cpp | 4 ++++ tests/basics/visitingtool-extended-test.cpp | 4 ++++ tests/basics/visitingtool-test.cpp | 4 ++++ tests/core/application/subsystem-runner-test.cpp | 4 ++++ tests/core/backend/engine/dummy-job.cpp | 4 ++++ tests/core/backend/engine/dummy-job.hpp | 4 ++++ tests/core/backend/engine/job-hash-test.cpp | 4 ++++ tests/core/backend/engine/scheduler-interface-test.cpp | 4 ++++ tests/core/backend/media-access-mock-test.cpp | 4 ++++ tests/core/backend/media-access-mock.hpp | 4 ++++ tests/core/proc/asset/asset-category-test.cpp | 4 ++++ tests/core/proc/asset/basicpipetest.cpp | 4 ++++ tests/core/proc/asset/compoundmediatest.cpp | 4 ++++ tests/core/proc/asset/create-asset-test.cpp | 4 ++++ tests/core/proc/asset/deleteassettest.cpp | 4 ++++ tests/core/proc/asset/dependent-assets-test.cpp | 4 ++++ tests/core/proc/asset/entry-id-test.cpp | 4 ++++ tests/core/proc/asset/identityofassetstest.cpp | 4 ++++ tests/core/proc/asset/makecliptest.cpp | 4 ++++ tests/core/proc/asset/mediastructurequerytest.cpp | 4 ++++ tests/core/proc/asset/meta/time-grid-basics-test.cpp | 4 ++++ tests/core/proc/asset/orderingofassetstest.cpp | 4 ++++ tests/core/proc/asset/testasset.cpp | 4 ++++ tests/core/proc/asset/testasset.hpp | 4 ++++ tests/core/proc/asset/testclipasset.hpp | 4 ++++ tests/core/proc/asset/typed-id-test.cpp | 4 ++++ tests/core/proc/control/argument-tuple-accept-test.cpp | 4 ++++ tests/core/proc/control/command-argument-test.cpp | 4 ++++ tests/core/proc/control/command-basic-test.cpp | 4 ++++ tests/core/proc/control/command-binding-test.cpp | 4 ++++ tests/core/proc/control/command-clone-builder-test.cpp | 4 ++++ tests/core/proc/control/command-equality-test.cpp | 4 ++++ tests/core/proc/control/command-message-binding-test.cpp | 4 ++++ tests/core/proc/control/command-mutation-test.cpp | 4 ++++ tests/core/proc/control/command-registry-test.cpp | 4 ++++ tests/core/proc/control/command-use1-test.cpp | 4 ++++ tests/core/proc/control/command-use2-test.cpp | 4 ++++ tests/core/proc/control/command-use3-test.cpp | 4 ++++ tests/core/proc/control/handling-pattern-basics-test.cpp | 4 ++++ .../proc/control/handling-pattern-standard-impl-test.cpp | 4 ++++ tests/core/proc/control/memento-tie-test.cpp | 4 ++++ tests/core/proc/control/test-dummy-commands.cpp | 4 ++++ tests/core/proc/engine/buff-table-test.cpp | 4 ++++ tests/core/proc/engine/buffer-metadata-key-test.cpp | 4 ++++ tests/core/proc/engine/buffer-metadata-test.cpp | 4 ++++ tests/core/proc/engine/buffer-provider-protocol-test.cpp | 4 ++++ tests/core/proc/engine/calc-stream-test.cpp | 4 ++++ tests/core/proc/engine/dispatcher-interface-test.cpp | 4 ++++ tests/core/proc/engine/engine-interface-test.cpp | 4 ++++ tests/core/proc/engine/node-basic-test.cpp | 4 ++++ tests/core/proc/engine/node-fabrication-test.cpp | 4 ++++ tests/core/proc/engine/node-operation-test.cpp | 4 ++++ tests/core/proc/engine/node-source-test.cpp | 4 ++++ tests/core/proc/engine/testframe-test.cpp | 4 ++++ tests/core/proc/engine/testframe.cpp | 4 ++++ tests/core/proc/engine/testframe.hpp | 4 ++++ tests/core/proc/engine/tracking-heap-block-provider-test.cpp | 4 ++++ tests/core/proc/mobject/builder/buildertooltest.cpp | 4 ++++ tests/core/proc/mobject/builder/buildsegmenttest.cpp | 4 ++++ .../proc/mobject/builder/fixture-change-detector-test.cpp | 4 ++++ tests/core/proc/mobject/builder/model-port-registry-test.cpp | 4 ++++ .../proc/mobject/builder/segmentation-datastructure-test.cpp | 4 ++++ tests/core/proc/mobject/controller/rendersegmenttest.cpp | 4 ++++ tests/core/proc/mobject/mobject-interface-test.cpp | 4 ++++ tests/core/proc/mobject/mobject-ref-test.cpp | 4 ++++ tests/core/proc/mobject/output-mapping-test.cpp | 4 ++++ tests/core/proc/mobject/placement-basic-test.cpp | 4 ++++ tests/core/proc/mobject/placement-hierarchy-test.cpp | 4 ++++ tests/core/proc/mobject/placement-object-identity-test.cpp | 4 ++++ tests/core/proc/mobject/placement-ref-test.cpp | 4 ++++ tests/core/proc/mobject/session/addcliptest.cpp | 4 ++++ tests/core/proc/mobject/session/defs-manager-impl-test.cpp | 4 ++++ tests/core/proc/mobject/session/defs-manager-test.cpp | 4 ++++ tests/core/proc/mobject/session/defs-registry-impl-test.cpp | 4 ++++ tests/core/proc/mobject/session/deletecliptest.cpp | 4 ++++ .../core/proc/mobject/session/placement-index-query-test.cpp | 4 ++++ tests/core/proc/mobject/session/placement-index-test.cpp | 4 ++++ tests/core/proc/mobject/session/placement-scope-test.cpp | 4 ++++ tests/core/proc/mobject/session/query-focus-stack-test.cpp | 4 ++++ tests/core/proc/mobject/session/query-focus-test.cpp | 4 ++++ tests/core/proc/mobject/session/query-resolver-test.cpp | 4 ++++ tests/core/proc/mobject/session/rebuildfixturetest.cpp | 4 ++++ tests/core/proc/mobject/session/scope-path-test.cpp | 4 ++++ tests/core/proc/mobject/session/scope-query-test.cpp | 4 ++++ .../core/proc/mobject/session/session-element-query-test.cpp | 4 ++++ .../proc/mobject/session/session-element-tracker-test.cpp | 4 ++++ .../core/proc/mobject/session/session-modify-parts-test.cpp | 4 ++++ .../proc/mobject/session/session-service-access-test.cpp | 4 ++++ tests/core/proc/mobject/session/session-structure-test.cpp | 4 ++++ tests/core/proc/mobject/session/sessionmanagertest.cpp | 4 ++++ tests/core/proc/mobject/session/test-scope-invalid.hpp | 4 ++++ tests/core/proc/mobject/session/test-scopes.cpp | 4 ++++ tests/core/proc/mobject/session/test-scopes.hpp | 4 ++++ tests/core/proc/mobject/session/testclip.cpp | 4 ++++ tests/core/proc/mobject/session/testclip.hpp | 4 ++++ tests/core/proc/mobject/session/testroot.hpp | 4 ++++ tests/core/proc/mobject/session/testsession1.hpp | 4 ++++ .../proc/mobject/session/timeline-sequence-handling-test.cpp | 4 ++++ tests/core/proc/play/dummy-play-connection-test.cpp | 4 ++++ tests/core/proc/play/output-slot-protocol-test.cpp | 4 ++++ tests/core/proc/play/timing-constraints-test.cpp | 4 ++++ tests/gui/bus-term-test.cpp | 4 ++++ tests/gui/interact/state-map-grouping-storage-test.cpp | 4 ++++ tests/gui/test-gui-test.cpp | 4 ++++ tests/library/advice/advice-basics-test.cpp | 4 ++++ tests/library/advice/advice-binding-pattern-test.cpp | 4 ++++ tests/library/advice/advice-configuration-test.cpp | 4 ++++ tests/library/advice/advice-index-test.cpp | 4 ++++ tests/library/advice/advice-multiplicity-test.cpp | 4 ++++ tests/library/advice/advice-situations-test.cpp | 4 ++++ tests/library/allocation-cluster-test.cpp | 4 ++++ tests/library/app-config-test.cpp | 4 ++++ tests/library/bool-checkable-test.cpp | 4 ++++ tests/library/cmdline-wrapper-test.cpp | 4 ++++ tests/library/custom-shared-ptr-test.cpp | 4 ++++ tests/library/del-stash-test.cpp | 4 ++++ tests/library/dependency-factory-test.cpp | 4 ++++ tests/library/diff/diff-complex-application-test.cpp | 4 ++++ tests/library/diff/diff-index-table-test.cpp | 4 ++++ tests/library/diff/diff-list-application-test.cpp | 4 ++++ tests/library/diff/diff-list-generation-test.cpp | 4 ++++ tests/library/diff/diff-tree-application-test.cpp | 4 ++++ tests/library/diff/gen-node-basic-test.cpp | 4 ++++ tests/library/diff/generic-record-representation-test.cpp | 4 ++++ tests/library/diff/tree-mutator-binding-test.cpp | 4 ++++ tests/library/diff/tree-mutator-test.cpp | 4 ++++ tests/library/exceptionerrortest.cpp | 4 ++++ tests/library/format-cout-test.cpp | 4 ++++ tests/library/format-helper-test.cpp | 4 ++++ tests/library/format-string-test.cpp | 4 ++++ tests/library/functor-util-test.cpp | 4 ++++ tests/library/hash-generator-test.cpp | 4 ++++ tests/library/hash-indexed-test.cpp | 4 ++++ tests/library/hash-standard-to-boost-bridge-test.cpp | 4 ++++ tests/library/helloworldtest.cpp | 4 ++++ tests/library/hierarchy-orientation-indicator-test.cpp | 4 ++++ tests/library/idi/generic-id-function-test.cpp | 4 ++++ tests/library/item-wrapper-test.cpp | 4 ++++ tests/library/iter-adapter-stl-test.cpp | 4 ++++ tests/library/iter-adapter-test.cpp | 4 ++++ tests/library/iter-cursor-test.cpp | 4 ++++ tests/library/iter-explorer-test.cpp | 4 ++++ tests/library/iter-queue-test.cpp | 4 ++++ tests/library/iter-source-test.cpp | 4 ++++ tests/library/iter-stack-test.cpp | 4 ++++ tests/library/itertools-test.cpp | 4 ++++ tests/library/lifecycletest.cpp | 4 ++++ tests/library/linked-elements-test.cpp | 4 ++++ tests/library/maybe-value-test.cpp | 4 ++++ tests/library/meta/access-casted-test.cpp | 4 ++++ tests/library/meta/duck-detector-test.cpp | 4 ++++ tests/library/meta/dummy-functions.hpp | 4 ++++ tests/library/meta/function-composition-test.cpp | 4 ++++ tests/library/meta/function-erasure-test.cpp | 4 ++++ tests/library/meta/generator-combinations-test.cpp | 4 ++++ tests/library/meta/iterable-classification-test.cpp | 4 ++++ tests/library/meta/meta-utils-test.cpp | 4 ++++ tests/library/meta/tuple-record-init-test.cpp | 4 ++++ tests/library/meta/type-demangling-test.cpp | 4 ++++ tests/library/meta/type-display-test.cpp | 4 ++++ tests/library/meta/typelist-test.cpp | 4 ++++ tests/library/meta/typelist-util-test.cpp | 4 ++++ tests/library/meta/virtual-copy-support-test.cpp | 4 ++++ tests/library/multifact-argument-test.cpp | 4 ++++ tests/library/multifact-singleton-test.cpp | 4 ++++ tests/library/multifact-test.cpp | 4 ++++ tests/library/null-value-test.cpp | 4 ++++ tests/library/opaque-holder-test.cpp | 4 ++++ tests/library/opaque-unchecked-buffer-test.cpp | 4 ++++ tests/library/optional-ref-test.cpp | 4 ++++ tests/library/polymorphic-value-test.cpp | 4 ++++ tests/library/query-text-test.cpp | 4 ++++ tests/library/query/query-utils-test.cpp | 4 ++++ tests/library/ref-array-test.cpp | 4 ++++ tests/library/removefromsettest.cpp | 4 ++++ tests/library/sanitised-identifier-test.cpp | 4 ++++ tests/library/scoped-collection-test.cpp | 4 ++++ tests/library/scoped-holder-test.cpp | 4 ++++ tests/library/scoped-holder-transfer-test.cpp | 4 ++++ tests/library/scoped-ptrvect-test.cpp | 4 ++++ tests/library/search-path-splitter-test.cpp | 4 ++++ tests/library/simple-allocator-test.cpp | 4 ++++ tests/library/singleton-subclass-test.cpp | 4 ++++ tests/library/singleton-test.cpp | 4 ++++ tests/library/singleton-testmock-test.cpp | 4 ++++ tests/library/sub-id-test.cpp | 4 ++++ tests/library/symbol-hashtable-test.cpp | 4 ++++ tests/library/symbol-test.cpp | 4 ++++ tests/library/test-target-obj.hpp | 4 ++++ tests/library/test/test-event-log-test.cpp | 4 ++++ tests/library/test/test-helper-test.cpp | 4 ++++ tests/library/test/test-helper-variadic-test.cpp | 4 ++++ tests/library/test/test-option-test.cpp | 4 ++++ tests/library/typed-allocation-manager-test.cpp | 4 ++++ tests/library/unique-malloc-owner-test.cpp | 4 ++++ tests/library/util-collection-test.cpp | 4 ++++ tests/library/util-floordiv-test.cpp | 4 ++++ tests/library/util-floorwrap-test.cpp | 4 ++++ tests/library/util-foreach-test.cpp | 4 ++++ tests/library/variant-test.cpp | 4 ++++ tests/library/vector-transfer-test.cpp | 4 ++++ tests/library/verb-function-dispatch-test.cpp | 4 ++++ tests/operation/bugs/hello-bug-test.cpp | 4 ++++ tests/plugin/test-cpp-plugin/example_plugin.cpp | 4 ++++ tests/testrunner.cpp | 4 ++++ 552 files changed, 2534 insertions(+) diff --git a/src/backend/engine/engine-config.cpp b/src/backend/engine/engine-config.cpp index f66d2de27..8eaa421ba 100644 --- a/src/backend/engine/engine-config.cpp +++ b/src/backend/engine/engine-config.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "backend/engine/engine-config.h" #include "lib/time/timevalue.hpp" diff --git a/src/backend/engine/scheduler-frontend.cpp b/src/backend/engine/scheduler-frontend.cpp index 629849492..e79823723 100644 --- a/src/backend/engine/scheduler-frontend.cpp +++ b/src/backend/engine/scheduler-frontend.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/error.h" #include "backend/engine/scheduler-frontend.hpp" diff --git a/src/backend/engine/scheduler-frontend.hpp b/src/backend/engine/scheduler-frontend.hpp index 1b0b23cce..cdf356e47 100644 --- a/src/backend/engine/scheduler-frontend.hpp +++ b/src/backend/engine/scheduler-frontend.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef BACKEND_ENGINE_SCHEDULER_FRONTEND_H #define BACKEND_ENGINE_SCHEDULER_FRONTEND_H diff --git a/src/backend/enginefacade.cpp b/src/backend/enginefacade.cpp index f93e309fe..d147bfb72 100644 --- a/src/backend/enginefacade.cpp +++ b/src/backend/enginefacade.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "backend/enginefacade.hpp" #include "lib/depend.hpp" diff --git a/src/backend/enginefacade.hpp b/src/backend/enginefacade.hpp index 64717e567..b09cceefd 100644 --- a/src/backend/enginefacade.hpp +++ b/src/backend/enginefacade.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef BACKEND_INTERFACE_ENGINEFACADE_H #define BACKEND_INTERFACE_ENGINEFACADE_H diff --git a/src/backend/media-access-facade.cpp b/src/backend/media-access-facade.cpp index d35a8a1e1..fd6227fc5 100644 --- a/src/backend/media-access-facade.cpp +++ b/src/backend/media-access-facade.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "backend/media-access-facade.hpp" #include "lib/util.hpp" diff --git a/src/backend/media-access-facade.hpp b/src/backend/media-access-facade.hpp index 6ec32c9a7..a3e5fcf2b 100644 --- a/src/backend/media-access-facade.hpp +++ b/src/backend/media-access-facade.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef BACKEND_INTERFACE_MEDIA_ACCESS_FACADE_H #define BACKEND_INTERFACE_MEDIA_ACCESS_FACADE_H diff --git a/src/backend/netnodefacade.cpp b/src/backend/netnodefacade.cpp index e084958ed..5e0d11a49 100644 --- a/src/backend/netnodefacade.cpp +++ b/src/backend/netnodefacade.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "backend/netnodefacade.hpp" #include "lib/depend.hpp" diff --git a/src/backend/netnodefacade.hpp b/src/backend/netnodefacade.hpp index 83b0d7be5..8b037c728 100644 --- a/src/backend/netnodefacade.hpp +++ b/src/backend/netnodefacade.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef BACKEND_INTERFACE_NETNODEFACADE_H #define BACKEND_INTERFACE_NETNODEFACADE_H diff --git a/src/backend/real-clock.cpp b/src/backend/real-clock.cpp index 9e758057a..d8ceace8c 100644 --- a/src/backend/real-clock.cpp +++ b/src/backend/real-clock.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "backend/real-clock.hpp" #include diff --git a/src/backend/scriptrunnerfacade.cpp b/src/backend/scriptrunnerfacade.cpp index 118d79061..6797b59cf 100644 --- a/src/backend/scriptrunnerfacade.cpp +++ b/src/backend/scriptrunnerfacade.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "backend/scriptrunnerfacade.hpp" #include "lib/depend.hpp" diff --git a/src/backend/scriptrunnerfacade.hpp b/src/backend/scriptrunnerfacade.hpp index 7ace30927..75bf420b0 100644 --- a/src/backend/scriptrunnerfacade.hpp +++ b/src/backend/scriptrunnerfacade.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef BACKEND_INTERFACE_SCRIPTRUNNERFACADE_H #define BACKEND_INTERFACE_SCRIPTRUNNERFACADE_H diff --git a/src/backend/thread-wrapper.hpp b/src/backend/thread-wrapper.hpp index 62e04d026..d395625a8 100644 --- a/src/backend/thread-wrapper.hpp +++ b/src/backend/thread-wrapper.hpp @@ -22,6 +22,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_THREADWRAPPER_H #define LIB_THREADWRAPPER_H diff --git a/src/backend/threadpool-init.cpp b/src/backend/threadpool-init.cpp index 604a6a8ac..f2c57c942 100644 --- a/src/backend/threadpool-init.cpp +++ b/src/backend/threadpool-init.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "backend/threadpool-init.hpp" diff --git a/src/common/advice/binding.cpp b/src/common/advice/binding.cpp index 69bb45e77..e5197d98f 100644 --- a/src/common/advice/binding.cpp +++ b/src/common/advice/binding.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/util.hpp" #include "lib/symbol.hpp" #include "common/advice/binding.hpp" diff --git a/src/common/appstate.cpp b/src/common/appstate.cpp index b8977786b..d8ff7f360 100644 --- a/src/common/appstate.cpp +++ b/src/common/appstate.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/error.hpp" #include "include/lifecycle.h" #include "common/appstate.hpp" diff --git a/src/common/basic-setup.cpp b/src/common/basic-setup.cpp index 4087b17e9..fd2ac1055 100644 --- a/src/common/basic-setup.cpp +++ b/src/common/basic-setup.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "common/basic-setup.hpp" #include "lib/searchpath.hpp" #include "lib/error.hpp" diff --git a/src/common/basic-setup.hpp b/src/common/basic-setup.hpp index 2f53da2bf..33c0e61af 100644 --- a/src/common/basic-setup.hpp +++ b/src/common/basic-setup.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef COMMON_BASIC_SETUP_H #define COMMON_BASIC_SETUP_H diff --git a/src/common/configfacade.cpp b/src/common/configfacade.cpp index 8c8d7b941..40fc94974 100644 --- a/src/common/configfacade.cpp +++ b/src/common/configfacade.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "include/logging.h" #include "include/lifecycle.h" #include "include/config-facade.h" diff --git a/src/common/guifacade.cpp b/src/common/guifacade.cpp index 333b32a69..88041404a 100644 --- a/src/common/guifacade.cpp +++ b/src/common/guifacade.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/guifacade.hpp" #include "include/guinotification-facade.h" #include "lib/sync.hpp" diff --git a/src/common/interfaceproxy.cpp b/src/common/interfaceproxy.cpp index 814f991b4..8fd627b42 100644 --- a/src/common/interfaceproxy.cpp +++ b/src/common/interfaceproxy.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "include/interfaceproxy.hpp" #include "common/instancehandle.hpp" #include "lib/error.hpp" diff --git a/src/common/option.cpp b/src/common/option.cpp index 1408ff861..6d4c78044 100644 --- a/src/common/option.cpp +++ b/src/common/option.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/error.hpp" #include "lib/util.hpp" #include "common/option.hpp" diff --git a/src/common/option.hpp b/src/common/option.hpp index e400702e3..38ae06c60 100644 --- a/src/common/option.hpp +++ b/src/common/option.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LUMIERA_OPTION_H #define LUMIERA_OPTION_H diff --git a/src/common/query/config-rules.cpp b/src/common/query/config-rules.cpp index 54826301f..033603f1d 100644 --- a/src/common/query/config-rules.cpp +++ b/src/common/query/config-rules.cpp @@ -22,6 +22,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/error.hpp" #include "common/query.hpp" #include "common/config-rules.hpp" diff --git a/src/common/query/defs-manager.hpp b/src/common/query/defs-manager.hpp index 1338f3a91..ab58d5251 100644 --- a/src/common/query/defs-manager.hpp +++ b/src/common/query/defs-manager.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LUMIERA_QUERY_DEFS_MANAGER_H #define LUMIERA_QUERY_DEFS_MANAGER_H diff --git a/src/common/query/query-resolver.cpp b/src/common/query/query-resolver.cpp index f6bdbbf60..76cc0acaa 100644 --- a/src/common/query/query-resolver.cpp +++ b/src/common/query/query-resolver.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/multifact.hpp" #include "common/query/query-resolver.hpp" diff --git a/src/common/query/query-resolver.hpp b/src/common/query/query-resolver.hpp index 9f67675f0..eab400f61 100644 --- a/src/common/query/query-resolver.hpp +++ b/src/common/query/query-resolver.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LUMIERA_QUERY_RESOLVER_H #define LUMIERA_QUERY_RESOLVER_H diff --git a/src/common/subsys.cpp b/src/common/subsys.cpp index 2a9b2446c..4c8202ab5 100644 --- a/src/common/subsys.cpp +++ b/src/common/subsys.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "common/subsys.hpp" diff --git a/src/common/subsystem-runner.hpp b/src/common/subsystem-runner.hpp index e6ffe5a59..8927c8e2f 100644 --- a/src/common/subsystem-runner.hpp +++ b/src/common/subsystem-runner.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LUMIERA_SUBSYSTEMRUNNER_H #define LUMIERA_SUBSYSTEMRUNNER_H diff --git a/src/gui/ctrl/playback-controller.cpp b/src/gui/ctrl/playback-controller.cpp index c78ee2fd4..8fe1bd400 100644 --- a/src/gui/ctrl/playback-controller.cpp +++ b/src/gui/ctrl/playback-controller.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/ctrl/playback-controller.hpp" #include "gui/display-service.hpp" #include "lib/error.hpp" diff --git a/src/gui/dialog/dialog.hpp b/src/gui/dialog/dialog.hpp index 318490624..8d669c778 100644 --- a/src/gui/dialog/dialog.hpp +++ b/src/gui/dialog/dialog.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_DIALOG_DIALOG_H #define GUI_DIALOG_DIALOG_H diff --git a/src/gui/dialog/name-chooser.cpp b/src/gui/dialog/name-chooser.cpp index 1d52e3c2d..0b057b10d 100644 --- a/src/gui/dialog/name-chooser.cpp +++ b/src/gui/dialog/name-chooser.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/gtk-lumiera.hpp" #include "gui/dialog/name-chooser.hpp" #include "gui/dialog/dialog.hpp" diff --git a/src/gui/dialog/name-chooser.hpp b/src/gui/dialog/name-chooser.hpp index 4e202b0be..903adf63b 100644 --- a/src/gui/dialog/name-chooser.hpp +++ b/src/gui/dialog/name-chooser.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_DIALOG_NAME_CHOOSER_H #define GUI_DIALOG_NAME_CHOOSER_H diff --git a/src/gui/dialog/preferences-dialog.hpp b/src/gui/dialog/preferences-dialog.hpp index 51a726d69..e25f3f43c 100644 --- a/src/gui/dialog/preferences-dialog.hpp +++ b/src/gui/dialog/preferences-dialog.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_DIALOG_PREFERENCES_DIALOG_H #define GUI_DIALOG_PREFERENCES_DIALOG_H diff --git a/src/gui/dialog/render.cpp b/src/gui/dialog/render.cpp index 5cc136875..0d47c3b10 100644 --- a/src/gui/dialog/render.cpp +++ b/src/gui/dialog/render.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/gtk-lumiera.hpp" #include "gui/dialog/render.hpp" diff --git a/src/gui/display-service.cpp b/src/gui/display-service.cpp index 8aedac1bc..577307091 100644 --- a/src/gui/display-service.cpp +++ b/src/gui/display-service.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/display-service.hpp" extern "C" { diff --git a/src/gui/gtk-lumiera.cpp b/src/gui/gtk-lumiera.cpp index 3f3719d69..3dc27ddae 100644 --- a/src/gui/gtk-lumiera.cpp +++ b/src/gui/gtk-lumiera.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/gtk-lumiera.hpp" #include "gui/window-manager.hpp" #include "gui/workspace/workspace-window.hpp" diff --git a/src/gui/model/clip-track.cpp b/src/gui/model/clip-track.cpp index fe71b2dfd..fa68ff3af 100644 --- a/src/gui/model/clip-track.cpp +++ b/src/gui/model/clip-track.cpp @@ -20,6 +20,11 @@ * *****************************************************/ + +/** @file §§§ + ** TODO §§§ + */ + #include "clip-track.hpp" #include "clip.hpp" diff --git a/src/gui/model/clip.cpp b/src/gui/model/clip.cpp index f78e2c2af..6c695c8f9 100644 --- a/src/gui/model/clip.cpp +++ b/src/gui/model/clip.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/model/clip.hpp" #include "lib/time/mutation.hpp" diff --git a/src/gui/model/group-track.cpp b/src/gui/model/group-track.cpp index 067821d82..b031c64b3 100644 --- a/src/gui/model/group-track.cpp +++ b/src/gui/model/group-track.cpp @@ -20,6 +20,11 @@ * *****************************************************/ + +/** @file §§§ + ** TODO §§§ + */ + #include "group-track.hpp" namespace gui { diff --git a/src/gui/model/parent-track.cpp b/src/gui/model/parent-track.cpp index 750edeacf..5865f3720 100644 --- a/src/gui/model/parent-track.cpp +++ b/src/gui/model/parent-track.cpp @@ -20,6 +20,11 @@ * *****************************************************/ + +/** @file §§§ + ** TODO §§§ + */ + #include "parent-track.hpp" #include diff --git a/src/gui/model/project.cpp b/src/gui/model/project.cpp index 78ebc0e8e..f79c03402 100644 --- a/src/gui/model/project.cpp +++ b/src/gui/model/project.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/model/project.hpp" #include "gui/model/sequence.hpp" diff --git a/src/gui/model/sequence.cpp b/src/gui/model/sequence.cpp index 830420c83..addb8c817 100644 --- a/src/gui/model/sequence.cpp +++ b/src/gui/model/sequence.cpp @@ -20,6 +20,11 @@ * *****************************************************/ + +/** @file §§§ + ** TODO §§§ + */ + #include "gui/model/sequence.hpp" #include "include/logging.h" diff --git a/src/gui/model/track.cpp b/src/gui/model/track.cpp index 35f0c2473..3b89062a5 100644 --- a/src/gui/model/track.cpp +++ b/src/gui/model/track.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/model/track.hpp" #include "gui/model/parent-track.hpp" diff --git a/src/gui/notification-service.cpp b/src/gui/notification-service.cpp index 3109cddaf..8dcfe35e8 100644 --- a/src/gui/notification-service.cpp +++ b/src/gui/notification-service.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/notification-service.hpp" #include "lib/depend.hpp" #include "include/logging.h" diff --git a/src/gui/output/displayer.cpp b/src/gui/output/displayer.cpp index ca1537913..bd7893e15 100644 --- a/src/gui/output/displayer.cpp +++ b/src/gui/output/displayer.cpp @@ -23,6 +23,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/gtk-lumiera.hpp" #include "gui/output/displayer.hpp" #include "gui/output/xvdisplayer.hpp" diff --git a/src/gui/output/gdkdisplayer.cpp b/src/gui/output/gdkdisplayer.cpp index f655f68ff..6cfa0cd20 100644 --- a/src/gui/output/gdkdisplayer.cpp +++ b/src/gui/output/gdkdisplayer.cpp @@ -23,6 +23,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/gtk-lumiera.hpp" #include "gui/output/gdkdisplayer.hpp" diff --git a/src/gui/output/xvdisplayer.cpp b/src/gui/output/xvdisplayer.cpp index eacb64de7..c958da31e 100644 --- a/src/gui/output/xvdisplayer.cpp +++ b/src/gui/output/xvdisplayer.cpp @@ -23,6 +23,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/gtk-lumiera.hpp" #include "gui/output/xvdisplayer.hpp" #include "include/logging.h" diff --git a/src/gui/panel/assets-panel.cpp b/src/gui/panel/assets-panel.cpp index f15baada0..2712de02d 100644 --- a/src/gui/panel/assets-panel.cpp +++ b/src/gui/panel/assets-panel.cpp @@ -20,6 +20,11 @@ * *****************************************************/ + +/** @file §§§ + ** TODO §§§ + */ + #include "gui/gtk-lumiera.hpp" #include "gui/panel/assets-panel.hpp" diff --git a/src/gui/panel/assets-panel.hpp b/src/gui/panel/assets-panel.hpp index acd65ef53..46b5507fa 100644 --- a/src/gui/panel/assets-panel.hpp +++ b/src/gui/panel/assets-panel.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_PANEL_ASSETS_PANEL_H #define GUI_PANEL_ASSETS_PANEL_H diff --git a/src/gui/panel/panel.cpp b/src/gui/panel/panel.cpp index d3c50a09c..e911cdf1c 100644 --- a/src/gui/panel/panel.cpp +++ b/src/gui/panel/panel.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/gtk-lumiera.hpp" #include "gui/panel/panel.hpp" #include "gui/workspace/panel-manager.hpp" diff --git a/src/gui/panel/panel.hpp b/src/gui/panel/panel.hpp index 9c1196d14..6379d262e 100644 --- a/src/gui/panel/panel.hpp +++ b/src/gui/panel/panel.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_PANEL_PANEL_H #define GUI_PANEL_PANEL_H diff --git a/src/gui/panel/timeline-panel.cpp b/src/gui/panel/timeline-panel.cpp index 84f3fa548..676894c3a 100644 --- a/src/gui/panel/timeline-panel.cpp +++ b/src/gui/panel/timeline-panel.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/gtk-lumiera.hpp" #include "gui/panel/timeline-panel.hpp" #include "gui/widget/timeline/timeline-zoom-scale.hpp" diff --git a/src/gui/panel/viewer-panel.cpp b/src/gui/panel/viewer-panel.cpp index 1d30919dc..bf359cae6 100644 --- a/src/gui/panel/viewer-panel.cpp +++ b/src/gui/panel/viewer-panel.cpp @@ -20,6 +20,11 @@ * *****************************************************/ + +/** @file §§§ + ** TODO §§§ + */ + #include "gui/gtk-lumiera.hpp" #include "gui/panel/viewer-panel.hpp" diff --git a/src/gui/ui-bus.cpp b/src/gui/ui-bus.cpp index 6b8062a80..6a1399cd6 100644 --- a/src/gui/ui-bus.cpp +++ b/src/gui/ui-bus.cpp @@ -22,6 +22,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/ui-bus.hpp" namespace gui { diff --git a/src/gui/util/cairo-util.cpp b/src/gui/util/cairo-util.cpp index 44fd395ec..95d4a3725 100644 --- a/src/gui/util/cairo-util.cpp +++ b/src/gui/util/cairo-util.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/util/cairo-util.hpp" namespace gui { diff --git a/src/gui/util/cairo-util.hpp b/src/gui/util/cairo-util.hpp index dcd30df69..9038cc95e 100644 --- a/src/gui/util/cairo-util.hpp +++ b/src/gui/util/cairo-util.hpp @@ -20,6 +20,11 @@ * *****************************************************/ + +/** @file §§§ + ** TODO §§§ + */ + #include #ifndef GUI_UTIL_CAIRO_H diff --git a/src/gui/util/rectangle.cpp b/src/gui/util/rectangle.cpp index 6ae7f34ee..e8abc2379 100644 --- a/src/gui/util/rectangle.cpp +++ b/src/gui/util/rectangle.cpp @@ -20,6 +20,11 @@ * *****************************************************/ + +/** @file §§§ + ** TODO §§§ + */ + #include "gui/util/rectangle.hpp" #include diff --git a/src/gui/util/rectangle.hpp b/src/gui/util/rectangle.hpp index ef8827eed..fb428ee74 100644 --- a/src/gui/util/rectangle.hpp +++ b/src/gui/util/rectangle.hpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_UTIL_RECTANGLE_H #define GUI_UTIL_RECTANGLE_H diff --git a/src/gui/widget/button-bar.cpp b/src/gui/widget/button-bar.cpp index 5d354eed1..91c15059a 100644 --- a/src/gui/widget/button-bar.cpp +++ b/src/gui/widget/button-bar.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/widget/button-bar.hpp" #include "include/logging.h" diff --git a/src/gui/widget/button-bar.hpp b/src/gui/widget/button-bar.hpp index 8af874eb4..da33f0601 100644 --- a/src/gui/widget/button-bar.hpp +++ b/src/gui/widget/button-bar.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_WIDGET_BUTTON_BAR_H #define GUI_WIDGET_BUTTON_BAR_H diff --git a/src/gui/widget/menu-button.cpp b/src/gui/widget/menu-button.cpp index bd3134941..f38a85873 100644 --- a/src/gui/widget/menu-button.cpp +++ b/src/gui/widget/menu-button.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/widget/menu-button.hpp" diff --git a/src/gui/widget/menu-button.hpp b/src/gui/widget/menu-button.hpp index 1da6d4aae..e43d96b1e 100644 --- a/src/gui/widget/menu-button.hpp +++ b/src/gui/widget/menu-button.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_WIDGET_MENU_BUTTON_H #define GUI_WIDGET_MENU_BUTTON_H diff --git a/src/gui/widget/mini-button.hpp b/src/gui/widget/mini-button.hpp index 6b2775b7f..42bc64150 100644 --- a/src/gui/widget/mini-button.hpp +++ b/src/gui/widget/mini-button.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_WIDGET_MINI_BUTTON_H #define GUI_WIDGET_MINI_BUTTON_H diff --git a/src/gui/widget/panel-bar.cpp b/src/gui/widget/panel-bar.cpp index b4ed380ee..6e4a6d311 100644 --- a/src/gui/widget/panel-bar.cpp +++ b/src/gui/widget/panel-bar.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/widget/panel-bar.hpp" #include "gui/workspace/workspace-window.hpp" #include "gui/workspace/panel-manager.hpp" diff --git a/src/gui/widget/timecode-widget.cpp b/src/gui/widget/timecode-widget.cpp index aa37787e8..a2f68c286 100644 --- a/src/gui/widget/timecode-widget.cpp +++ b/src/gui/widget/timecode-widget.cpp @@ -24,6 +24,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/widget/timecode-widget.hpp" #include "lib/time/diagnostics.hpp" ////////////TODO: temporary solution to get H:M:S components. Use TimeCode instead! diff --git a/src/gui/widget/timecode-widget.hpp b/src/gui/widget/timecode-widget.hpp index a896dc40a..920491230 100644 --- a/src/gui/widget/timecode-widget.hpp +++ b/src/gui/widget/timecode-widget.hpp @@ -24,6 +24,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_WIDGET_TIMECODE_WIDGET_H #define GUI_WIDGET_TIMECODE_WIDGET_H diff --git a/src/gui/widget/timeline-widget.cpp b/src/gui/widget/timeline-widget.cpp index 6f3ecdf52..1513020ad 100644 --- a/src/gui/widget/timeline-widget.cpp +++ b/src/gui/widget/timeline-widget.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/widget/timeline-widget.hpp" #include diff --git a/src/gui/widget/timeline/basic-draw-strategy.hpp b/src/gui/widget/timeline/basic-draw-strategy.hpp index 38bdeb305..4be0d36fd 100644 --- a/src/gui/widget/timeline/basic-draw-strategy.hpp +++ b/src/gui/widget/timeline/basic-draw-strategy.hpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_WIDGET_TIMELINE_BASIC_DRAW_STRATEGY_H #define GUI_WIDGET_TIMELINE_BASIC_DRAW_STRATEGY_H diff --git a/src/gui/widget/timeline/draw-strategy.cpp b/src/gui/widget/timeline/draw-strategy.cpp index 5a9f00d6b..be6b708a7 100644 --- a/src/gui/widget/timeline/draw-strategy.cpp +++ b/src/gui/widget/timeline/draw-strategy.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/widget/timeline/basic-draw-strategy.hpp" namespace gui { diff --git a/src/gui/widget/timeline/draw-strategy.hpp b/src/gui/widget/timeline/draw-strategy.hpp index 9dc8909ff..8520e8ad4 100644 --- a/src/gui/widget/timeline/draw-strategy.hpp +++ b/src/gui/widget/timeline/draw-strategy.hpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_WIDGET_TIMELINE_DRAW_STRATEGY_HPP #define GUI_WIDGET_TIMELINE_DRAW_STRATEGY_HPP diff --git a/src/gui/widget/timeline/timeline-arrow-tool.cpp b/src/gui/widget/timeline/timeline-arrow-tool.cpp index 5dd60848e..65d472be1 100644 --- a/src/gui/widget/timeline/timeline-arrow-tool.cpp +++ b/src/gui/widget/timeline/timeline-arrow-tool.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/widget/timeline/timeline-arrow-tool.hpp" namespace gui { diff --git a/src/gui/widget/timeline/timeline-body.cpp b/src/gui/widget/timeline/timeline-body.cpp index 15acdd6c1..8355a5fde 100644 --- a/src/gui/widget/timeline/timeline-body.cpp +++ b/src/gui/widget/timeline/timeline-body.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/widget/timeline/timeline-body.hpp" #include "gui/widget/timeline-widget.hpp" #include "gui/window-manager.hpp" diff --git a/src/gui/widget/timeline/timeline-clip-track.cpp b/src/gui/widget/timeline/timeline-clip-track.cpp index e734cad10..1e53747f2 100644 --- a/src/gui/widget/timeline/timeline-clip-track.cpp +++ b/src/gui/widget/timeline/timeline-clip-track.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/widget/timeline/timeline-clip.hpp" #include "gui/widget/timeline/timeline-clip-track.hpp" #include "gui/widget/timeline/timeline-view-window.hpp" diff --git a/src/gui/widget/timeline/timeline-clip.cpp b/src/gui/widget/timeline/timeline-clip.cpp index c8ee93bd3..23d6ea98b 100644 --- a/src/gui/widget/timeline/timeline-clip.cpp +++ b/src/gui/widget/timeline/timeline-clip.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/widget/timeline/timeline-clip.hpp" namespace gui { diff --git a/src/gui/widget/timeline/timeline-entity.cpp b/src/gui/widget/timeline/timeline-entity.cpp index 672f3e9c1..851cd4be7 100644 --- a/src/gui/widget/timeline/timeline-entity.cpp +++ b/src/gui/widget/timeline/timeline-entity.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/gtk-lumiera.hpp" #include "gui/widget/timeline/timeline-entity.hpp" #include "gui/widget/timeline/draw-strategy.hpp" diff --git a/src/gui/widget/timeline/timeline-group-track.cpp b/src/gui/widget/timeline/timeline-group-track.cpp index 6f7660a3c..283fc8fc8 100644 --- a/src/gui/widget/timeline/timeline-group-track.cpp +++ b/src/gui/widget/timeline/timeline-group-track.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/widget/timeline/timeline-group-track.hpp" #include "gui/widget/timeline-widget.hpp" diff --git a/src/gui/widget/timeline/timeline-group-track.hpp b/src/gui/widget/timeline/timeline-group-track.hpp index aa65f9848..4a3821de9 100644 --- a/src/gui/widget/timeline/timeline-group-track.hpp +++ b/src/gui/widget/timeline/timeline-group-track.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_WIDGET_TIMELINE_GROUP_TRACK_H #define GUI_WIDGET_TIMELINE_GROUP_TRACK_H diff --git a/src/gui/widget/timeline/timeline-header-container.cpp b/src/gui/widget/timeline/timeline-header-container.cpp index 708564ebc..56ae2cad9 100644 --- a/src/gui/widget/timeline/timeline-header-container.cpp +++ b/src/gui/widget/timeline/timeline-header-container.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/widget/timeline/timeline-header-container.hpp" #include "gui/widget/timeline/timeline-track.hpp" #include "gui/widget/timeline-widget.hpp" diff --git a/src/gui/widget/timeline/timeline-header-container.hpp b/src/gui/widget/timeline/timeline-header-container.hpp index 87a94ca2f..89d5f14a1 100644 --- a/src/gui/widget/timeline/timeline-header-container.hpp +++ b/src/gui/widget/timeline/timeline-header-container.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_WIDGET_TIMELINE_HEADER_CONTAINER_H #define GUI_WIDGET_TIMELINE_HEADER_CONTAINER_H diff --git a/src/gui/widget/timeline/timeline-header-widget.cpp b/src/gui/widget/timeline/timeline-header-widget.cpp index ef957dd56..cd388afd9 100644 --- a/src/gui/widget/timeline/timeline-header-widget.cpp +++ b/src/gui/widget/timeline/timeline-header-widget.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/widget/timeline-widget.hpp" #include "gui/util/rectangle.hpp" diff --git a/src/gui/widget/timeline/timeline-header-widget.hpp b/src/gui/widget/timeline/timeline-header-widget.hpp index c2151a662..e00cca46b 100644 --- a/src/gui/widget/timeline/timeline-header-widget.hpp +++ b/src/gui/widget/timeline/timeline-header-widget.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_WIDGET_HEADER_WIDGET_H #define GUI_WIDGET_HEADER_WIDGET_H diff --git a/src/gui/widget/timeline/timeline-ibeam-tool.cpp b/src/gui/widget/timeline/timeline-ibeam-tool.cpp index f86fa1453..cd017a095 100644 --- a/src/gui/widget/timeline/timeline-ibeam-tool.cpp +++ b/src/gui/widget/timeline/timeline-ibeam-tool.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/widget/timeline/timeline-ibeam-tool.hpp" #include "gui/widget/timeline-widget.hpp" #include "lib/time/mutation.hpp" diff --git a/src/gui/widget/timeline/timeline-layout-helper.cpp b/src/gui/widget/timeline/timeline-layout-helper.cpp index c0cf65483..357765c15 100644 --- a/src/gui/widget/timeline/timeline-layout-helper.cpp +++ b/src/gui/widget/timeline/timeline-layout-helper.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/widget/timeline/timeline-layout-helper.hpp" #include "gui/widget/timeline-widget.hpp" #include "gui/model/sequence.hpp" diff --git a/src/gui/widget/timeline/timeline-ruler.cpp b/src/gui/widget/timeline/timeline-ruler.cpp index 2c0cd8743..8c527948d 100644 --- a/src/gui/widget/timeline/timeline-ruler.cpp +++ b/src/gui/widget/timeline/timeline-ruler.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/widget/timeline/timeline-ruler.hpp" #include "gui/widget/timeline-widget.hpp" #include "gui/window-manager.hpp" diff --git a/src/gui/widget/timeline/timeline-ruler.hpp b/src/gui/widget/timeline/timeline-ruler.hpp index 88201aebf..3783f4bb9 100644 --- a/src/gui/widget/timeline/timeline-ruler.hpp +++ b/src/gui/widget/timeline/timeline-ruler.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_WIDGET_TIMELINE_RULER_H #define GUI_WIDGET_TIMELINE_RULER_H diff --git a/src/gui/widget/timeline/timeline-state.cpp b/src/gui/widget/timeline/timeline-state.cpp index 3eec7bd2a..955ec69fa 100644 --- a/src/gui/widget/timeline/timeline-state.cpp +++ b/src/gui/widget/timeline/timeline-state.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/widget/timeline/timeline-state.hpp" #include "lib/time/timevalue.hpp" #include "lib/time/mutation.hpp" diff --git a/src/gui/widget/timeline/timeline-state.hpp b/src/gui/widget/timeline/timeline-state.hpp index 642b2c2cd..bea468d3e 100644 --- a/src/gui/widget/timeline/timeline-state.hpp +++ b/src/gui/widget/timeline/timeline-state.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_WIDGET_TIMELINE_STATE_H #define GUI_WIDGET_TIMELINE_STATE_H diff --git a/src/gui/widget/timeline/timeline-tool.cpp b/src/gui/widget/timeline/timeline-tool.cpp index c5e40ad88..64a6bc68e 100644 --- a/src/gui/widget/timeline/timeline-tool.cpp +++ b/src/gui/widget/timeline/timeline-tool.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/widget/timeline/timeline-tool.hpp" #include "gui/widget/timeline-widget.hpp" diff --git a/src/gui/widget/timeline/timeline-tool.hpp b/src/gui/widget/timeline/timeline-tool.hpp index dc6b57853..946d41398 100644 --- a/src/gui/widget/timeline/timeline-tool.hpp +++ b/src/gui/widget/timeline/timeline-tool.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_WIDGET_TIMELINE_TOOL_H #define GUI_WIDGET_TIMELINE_TOOL_H diff --git a/src/gui/widget/timeline/timeline-track.cpp b/src/gui/widget/timeline/timeline-track.cpp index 5206c5585..a43bc666a 100644 --- a/src/gui/widget/timeline/timeline-track.cpp +++ b/src/gui/widget/timeline/timeline-track.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/widget/timeline/timeline-track.hpp" #include "gui/widget/timeline-widget.hpp" #include "gui/window-manager.hpp" diff --git a/src/gui/widget/timeline/timeline-track.hpp b/src/gui/widget/timeline/timeline-track.hpp index c418294f5..72b009aab 100644 --- a/src/gui/widget/timeline/timeline-track.hpp +++ b/src/gui/widget/timeline/timeline-track.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_WIDGET_TIMELINE_TRACK_H #define GUI_WIDGET_TIMELINE_TRACK_H diff --git a/src/gui/widget/timeline/timeline-view-window.cpp b/src/gui/widget/timeline/timeline-view-window.cpp index b226552b3..be2d6d2f3 100644 --- a/src/gui/widget/timeline/timeline-view-window.cpp +++ b/src/gui/widget/timeline/timeline-view-window.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/widget/timeline/timeline-view-window.hpp" #include "gui/widget/timeline-widget.hpp" diff --git a/src/gui/widget/timeline/timeline-view-window.hpp b/src/gui/widget/timeline/timeline-view-window.hpp index fc5b255ff..345e75540 100644 --- a/src/gui/widget/timeline/timeline-view-window.hpp +++ b/src/gui/widget/timeline/timeline-view-window.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_WIDGET_TIMELINE_VIEW_WINDOW_H #define GUI_WIDGET_TIMELINE_VIEW_WINDOW_H diff --git a/src/gui/widget/timeline/timeline-zoom-scale.cpp b/src/gui/widget/timeline/timeline-zoom-scale.cpp index beac2ef86..5f9b9bf37 100644 --- a/src/gui/widget/timeline/timeline-zoom-scale.cpp +++ b/src/gui/widget/timeline/timeline-zoom-scale.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/widget/timeline-widget.hpp" #include "gui/widget/timeline/timeline-zoom-scale.hpp" diff --git a/src/gui/widget/timeline/timeline-zoom-scale.hpp b/src/gui/widget/timeline/timeline-zoom-scale.hpp index e2ca1a91b..62206a11e 100644 --- a/src/gui/widget/timeline/timeline-zoom-scale.hpp +++ b/src/gui/widget/timeline/timeline-zoom-scale.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_WIDGET_TIMELINE_ZOOM_SCALE_H #define GUI_WIDGET_TIMELINE_ZOOM_SCALE_H diff --git a/src/gui/widget/video-display-widget.cpp b/src/gui/widget/video-display-widget.cpp index fb976021f..7cf603e8b 100644 --- a/src/gui/widget/video-display-widget.cpp +++ b/src/gui/widget/video-display-widget.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/gtk-lumiera.hpp" #include "gui/output/xvdisplayer.hpp" #include "gui/output/gdkdisplayer.hpp" diff --git a/src/gui/widget/video-display-widget.hpp b/src/gui/widget/video-display-widget.hpp index 2e9bcde49..aaca812e0 100644 --- a/src/gui/widget/video-display-widget.hpp +++ b/src/gui/widget/video-display-widget.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef GUI_WIDGET_VIDEO_DISPLAY_WIDGET_H diff --git a/src/gui/window-manager.cpp b/src/gui/window-manager.cpp index 73c295546..9d5bfd4be 100644 --- a/src/gui/window-manager.cpp +++ b/src/gui/window-manager.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/window-manager.hpp" #include "gui/gtk-lumiera.hpp" #include "gui/workspace/workspace-window.hpp" diff --git a/src/gui/workspace/actions.cpp b/src/gui/workspace/actions.cpp index f7eb6089c..267e8795e 100644 --- a/src/gui/workspace/actions.cpp +++ b/src/gui/workspace/actions.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/workspace/actions.hpp" #include "gui/workspace/workspace-window.hpp" diff --git a/src/gui/workspace/panel-manager.cpp b/src/gui/workspace/panel-manager.cpp index 873780aed..5930c6984 100644 --- a/src/gui/workspace/panel-manager.cpp +++ b/src/gui/workspace/panel-manager.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "gui/workspace/panel-manager.hpp" #include "gui/panel/assets-panel.hpp" diff --git a/src/gui/workspace/workspace-window.cpp b/src/gui/workspace/workspace-window.cpp index ea574fb04..1301bd88c 100644 --- a/src/gui/workspace/workspace-window.cpp +++ b/src/gui/workspace/workspace-window.cpp @@ -20,6 +20,11 @@ * *****************************************************/ + +/** @file §§§ + ** TODO §§§ + */ + #include "gui/gtk-lumiera.hpp" #include "workspace-window.hpp" #include "include/logging.h" diff --git a/src/lib/allocation-cluster.cpp b/src/lib/allocation-cluster.cpp index 5baeded2b..4abc2992d 100644 --- a/src/lib/allocation-cluster.cpp +++ b/src/lib/allocation-cluster.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/allocation-cluster.hpp" #include "lib/error.hpp" #include "lib/util.hpp" diff --git a/src/lib/bool-checkable.hpp b/src/lib/bool-checkable.hpp index b9c3d81f7..1f7203028 100644 --- a/src/lib/bool-checkable.hpp +++ b/src/lib/bool-checkable.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_BOOL_CHECKABLE_H #define LIB_BOOL_CHECKABLE_H diff --git a/src/lib/cmdline.cpp b/src/lib/cmdline.cpp index 174039840..fe9973de0 100644 --- a/src/lib/cmdline.cpp +++ b/src/lib/cmdline.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/util.hpp" #include "include/logging.h" diff --git a/src/lib/cmdline.hpp b/src/lib/cmdline.hpp index 2dba98262..e998f96e5 100644 --- a/src/lib/cmdline.hpp +++ b/src/lib/cmdline.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_CMDLINE_H #define LIB_CMDLINE_H diff --git a/src/lib/dependency-factory.hpp b/src/lib/dependency-factory.hpp index 818015bc9..8de45a237 100644 --- a/src/lib/dependency-factory.hpp +++ b/src/lib/dependency-factory.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_DEPENDENCY_FACTORY_H diff --git a/src/lib/frameid.hpp b/src/lib/frameid.hpp index 48a5ffe6b..202d0ff3d 100644 --- a/src/lib/frameid.hpp +++ b/src/lib/frameid.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LUMIERA_FRAMEID_H #define LUMIERA_FRAMEID_H diff --git a/src/lib/idi/genfunc.cpp b/src/lib/idi/genfunc.cpp index a1b5d4be3..69fa9496f 100644 --- a/src/lib/idi/genfunc.cpp +++ b/src/lib/idi/genfunc.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/idi/genfunc.hpp" #include "lib/format-string.hpp" #include "lib/format-obj.hpp" diff --git a/src/lib/lifecycle.cpp b/src/lib/lifecycle.cpp index 24bbf04ae..133d22e17 100644 --- a/src/lib/lifecycle.cpp +++ b/src/lib/lifecycle.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/error.hpp" #include "include/lifecycle.h" #include "lib/lifecycleregistry.hpp" diff --git a/src/lib/meta/maybe-compare.hpp b/src/lib/meta/maybe-compare.hpp index 502259a26..bf5ae828d 100644 --- a/src/lib/meta/maybe-compare.hpp +++ b/src/lib/meta/maybe-compare.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_META_MAYBE_COMPARE_H #define LIB_META_MAYBE_COMPARE_H diff --git a/src/lib/meta/no-instance.hpp b/src/lib/meta/no-instance.hpp index 73f7b71b0..d3f7ca4d0 100644 --- a/src/lib/meta/no-instance.hpp +++ b/src/lib/meta/no-instance.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_META_NO_INSTANCE_H #define LIB_META_NO_INSTANCE_H diff --git a/src/lib/meta/size-trait.hpp b/src/lib/meta/size-trait.hpp index 5a0ff6907..21578a7c6 100644 --- a/src/lib/meta/size-trait.hpp +++ b/src/lib/meta/size-trait.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_META_SIZE_TRAIT_H #define LIB_META_SIZE_TRAIT_H diff --git a/src/lib/meta/trait-special.hpp b/src/lib/meta/trait-special.hpp index 3bc3e5c53..694bd4191 100644 --- a/src/lib/meta/trait-special.hpp +++ b/src/lib/meta/trait-special.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_META_TRAIT_SPECIAL_H #define LIB_META_TRAIT_SPECIAL_H diff --git a/src/lib/nobug-init.cpp b/src/lib/nobug-init.cpp index 9c2b3cb95..c483310ad 100644 --- a/src/lib/nobug-init.cpp +++ b/src/lib/nobug-init.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/nobug-init.hpp" /// magic to generate NoBug logging definitions diff --git a/src/lib/nocopy.hpp b/src/lib/nocopy.hpp index 3f8fc8b36..b07b72a03 100644 --- a/src/lib/nocopy.hpp +++ b/src/lib/nocopy.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_NOCOPY_H #define LIB_NOCOPY_H diff --git a/src/lib/optional-ref.hpp b/src/lib/optional-ref.hpp index 71ce7393d..be0caabed 100644 --- a/src/lib/optional-ref.hpp +++ b/src/lib/optional-ref.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_OPTIONAL_REF_H #define LIB_OPTIONAL_REF_H diff --git a/src/lib/query-diagnostics.hpp b/src/lib/query-diagnostics.hpp index 812d5bc03..5c28a1077 100644 --- a/src/lib/query-diagnostics.hpp +++ b/src/lib/query-diagnostics.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_QUERY_DIAGNOSTICS_H #define LIB_QUERY_DIAGNOSTICS_H diff --git a/src/lib/query-text.cpp b/src/lib/query-text.cpp index 41705cfce..a2857387e 100644 --- a/src/lib/query-text.cpp +++ b/src/lib/query-text.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + //#include "lib/util.hpp" //#include "lib/symbol.hpp" //#include "include/logging.h" diff --git a/src/lib/query-util.cpp b/src/lib/query-util.cpp index b6fdc6421..6e101f073 100644 --- a/src/lib/query-util.cpp +++ b/src/lib/query-util.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/error.hpp" #include "lib/query-util.hpp" #include "lib/util.hpp" diff --git a/src/lib/query-util.hpp b/src/lib/query-util.hpp index 092fe5dba..0f90a56e1 100644 --- a/src/lib/query-util.hpp +++ b/src/lib/query-util.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_QUERY_UTIL_H #define LIB_QUERY_UTIL_H diff --git a/src/lib/ref-array.hpp b/src/lib/ref-array.hpp index ddbc06da1..4401687fa 100644 --- a/src/lib/ref-array.hpp +++ b/src/lib/ref-array.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_REF_ARRAY_H #define LIB_REF_ARRAY_H diff --git a/src/lib/scoped-holder-transfer.hpp b/src/lib/scoped-holder-transfer.hpp index 58508f393..17d47bda8 100644 --- a/src/lib/scoped-holder-transfer.hpp +++ b/src/lib/scoped-holder-transfer.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_SCOPEDHOLDER_TRANSFER_H #define LIB_SCOPEDHOLDER_TRANSFER_H diff --git a/src/lib/searchpath.cpp b/src/lib/searchpath.cpp index 2dda8d1d7..4ceaed302 100644 --- a/src/lib/searchpath.cpp +++ b/src/lib/searchpath.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/error.hpp" #include "lib/searchpath.hpp" #include "lib/symbol.hpp" diff --git a/src/lib/searchpath.hpp b/src/lib/searchpath.hpp index 35d787507..e9d66b8e8 100644 --- a/src/lib/searchpath.hpp +++ b/src/lib/searchpath.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef COMMON_SEARCHPATH_H #define COMMON_SEARCHPATH_H diff --git a/src/lib/test/depend-4test.hpp b/src/lib/test/depend-4test.hpp index 5178ab56d..e113cd74e 100644 --- a/src/lib/test/depend-4test.hpp +++ b/src/lib/test/depend-4test.hpp @@ -22,6 +22,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_TEST_DEPEND_4TEST_H #define LIB_TEST_DEPEND_4TEST_H diff --git a/src/lib/test/event-log.cpp b/src/lib/test/event-log.cpp index 7f7ee60d9..bd9699cae 100644 --- a/src/lib/test/event-log.cpp +++ b/src/lib/test/event-log.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/test/event-log.hpp" //#include "lib/format-string.hpp" diff --git a/src/lib/test/suite.cpp b/src/lib/test/suite.cpp index 44283aec3..22595a2ca 100644 --- a/src/lib/test/suite.cpp +++ b/src/lib/test/suite.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "include/logging.h" #include "lib/hash-standard.hpp" diff --git a/src/lib/test/test-coll.hpp b/src/lib/test/test-coll.hpp index 01e24e9dc..c9fc3974e 100644 --- a/src/lib/test/test-coll.hpp +++ b/src/lib/test/test-coll.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_TEST_TEST_COLL_H #define LIB_TEST_TEST_COLL_H diff --git a/src/lib/test/testdummy.hpp b/src/lib/test/testdummy.hpp index 27d4e79c7..e3924fcf5 100644 --- a/src/lib/test/testdummy.hpp +++ b/src/lib/test/testdummy.hpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include #include diff --git a/src/lib/test/testoption.cpp b/src/lib/test/testoption.cpp index 99ab9cb77..baff50496 100644 --- a/src/lib/test/testoption.cpp +++ b/src/lib/test/testoption.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/error.hpp" #include "lib/test/testoption.hpp" #include "lib/test/suite.hpp" diff --git a/src/lib/test/testoption.hpp b/src/lib/test/testoption.hpp index 9691b7b82..173d96ef5 100644 --- a/src/lib/test/testoption.hpp +++ b/src/lib/test/testoption.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef TESTHELPER_TESTOPTION_H #define TESTHELPER_TESTOPTION_H diff --git a/src/lib/time/formats.hpp b/src/lib/time/formats.hpp index c463428c1..d0209f105 100644 --- a/src/lib/time/formats.hpp +++ b/src/lib/time/formats.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_TIME_FORMATS_H #define LIB_TIME_FORMATS_H diff --git a/src/lib/time/grid.hpp b/src/lib/time/grid.hpp index c02ae4a3d..87013c8ed 100644 --- a/src/lib/time/grid.hpp +++ b/src/lib/time/grid.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_TIME_GRID_H #define LIB_TIME_GRID_H diff --git a/src/lib/time/quantiser.cpp b/src/lib/time/quantiser.cpp index f698e5b32..31382750b 100644 --- a/src/lib/time/quantiser.cpp +++ b/src/lib/time/quantiser.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/time/quantiser.hpp" #include "lib/time/timevalue.hpp" #include "lib/time/timequant.hpp" diff --git a/src/lib/time/quantiser.hpp b/src/lib/time/quantiser.hpp index 989a2e875..2cca06f50 100644 --- a/src/lib/time/quantiser.hpp +++ b/src/lib/time/quantiser.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_TIME_QUANTISER_H #define LIB_TIME_QUANTISER_H diff --git a/src/lib/time/timecode.cpp b/src/lib/time/timecode.cpp index 27ffc0eae..2012d0e9d 100644 --- a/src/lib/time/timecode.cpp +++ b/src/lib/time/timecode.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/time/timecode.hpp" #include "lib/time/timevalue.hpp" #include "lib/time/timequant.hpp" diff --git a/src/lib/time/timecode.hpp b/src/lib/time/timecode.hpp index 0493afdb7..d17b38811 100644 --- a/src/lib/time/timecode.hpp +++ b/src/lib/time/timecode.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_TIME_TIMECODE_H #define LIB_TIME_TIMECODE_H diff --git a/src/lib/time/timequant.hpp b/src/lib/time/timequant.hpp index 98eb475e7..1ce80e269 100644 --- a/src/lib/time/timequant.hpp +++ b/src/lib/time/timequant.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_TIME_TIMEQUANT_H #define LIB_TIME_TIMEQUANT_H diff --git a/src/lib/util-quant.hpp b/src/lib/util-quant.hpp index 5648135b9..466733eb8 100644 --- a/src/lib/util-quant.hpp +++ b/src/lib/util-quant.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_UTIL_QUANT_H #define LIB_UTIL_QUANT_H diff --git a/src/lib/util.cpp b/src/lib/util.cpp index 3b0660c2c..b55d124b0 100644 --- a/src/lib/util.cpp +++ b/src/lib/util.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/util.hpp" #include diff --git a/src/lib/util.hpp b/src/lib/util.hpp index c59675059..cb75db01e 100644 --- a/src/lib/util.hpp +++ b/src/lib/util.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LIB_UTIL_H #define LIB_UTIL_H diff --git a/src/lib/visitor-dispatcher.hpp b/src/lib/visitor-dispatcher.hpp index d3aa22690..3cf95dcc7 100644 --- a/src/lib/visitor-dispatcher.hpp +++ b/src/lib/visitor-dispatcher.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LUMIERA_VISITOR_DISPATCHER_H #define LUMIERA_VISITOR_DISPATCHER_H diff --git a/src/lib/wrapperptr.hpp b/src/lib/wrapperptr.hpp index c2bd6a64c..ba4b09318 100644 --- a/src/lib/wrapperptr.hpp +++ b/src/lib/wrapperptr.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef LUMIERA_WRAPPERPTR_H #define LUMIERA_WRAPPERPTR_H diff --git a/src/lumiera/main.cpp b/src/lumiera/main.cpp index 69b5ecc22..3d2ecd38f 100644 --- a/src/lumiera/main.cpp +++ b/src/lumiera/main.cpp @@ -22,6 +22,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #include "include/logging.h" #include "lib/error.hpp" #include "common/appstate.hpp" diff --git a/src/proc/asset.cpp b/src/proc/asset.cpp index 09927cd91..727f9e576 100644 --- a/src/proc/asset.cpp +++ b/src/proc/asset.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/asset.hpp" #include "proc/assetmanager.hpp" #include "lib/format-string.hpp" diff --git a/src/proc/asset/category.cpp b/src/proc/asset/category.cpp index 5016384d3..352814d64 100644 --- a/src/proc/asset/category.cpp +++ b/src/proc/asset/category.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/asset/category.hpp" #include "lib/util.hpp" #include "include/logging.h" diff --git a/src/proc/asset/category.hpp b/src/proc/asset/category.hpp index 1eddb6597..b3da246ab 100644 --- a/src/proc/asset/category.hpp +++ b/src/proc/asset/category.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_ASSET_CATEGORY_H #define PROC_ASSET_CATEGORY_H diff --git a/src/proc/asset/clip.cpp b/src/proc/asset/clip.cpp index 49483214e..0cb99de13 100644 --- a/src/proc/asset/clip.cpp +++ b/src/proc/asset/clip.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/asset/clip.hpp" #include "proc/mobject/session/mobjectfactory.hpp" ////TODO: avoidable? diff --git a/src/proc/asset/clip.hpp b/src/proc/asset/clip.hpp index 6117a58c4..27c02783a 100644 --- a/src/proc/asset/clip.hpp +++ b/src/proc/asset/clip.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ASSET_CLIP_H #define ASSET_CLIP_H diff --git a/src/proc/asset/codec.cpp b/src/proc/asset/codec.cpp index 08fd63713..afd723c25 100644 --- a/src/proc/asset/codec.cpp +++ b/src/proc/asset/codec.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/asset/codec.hpp" namespace proc { diff --git a/src/proc/asset/codec.hpp b/src/proc/asset/codec.hpp index 093470859..82cb9151e 100644 --- a/src/proc/asset/codec.hpp +++ b/src/proc/asset/codec.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ASSET_CODEC_H #define ASSET_CODEC_H diff --git a/src/proc/asset/compoundmedia.cpp b/src/proc/asset/compoundmedia.cpp index 115ce7708..0c3256205 100644 --- a/src/proc/asset/compoundmedia.cpp +++ b/src/proc/asset/compoundmedia.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/asset/compoundmedia.hpp" namespace proc { diff --git a/src/proc/asset/compoundmedia.hpp b/src/proc/asset/compoundmedia.hpp index c73c2c7d9..bed3e60aa 100644 --- a/src/proc/asset/compoundmedia.hpp +++ b/src/proc/asset/compoundmedia.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ASSET_COMPOUNDMEDIA_H #define ASSET_COMPOUNDMEDIA_H diff --git a/src/proc/asset/dataset.hpp b/src/proc/asset/dataset.hpp index 15d6f633c..8f030eec9 100644 --- a/src/proc/asset/dataset.hpp +++ b/src/proc/asset/dataset.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ASSET_DATASET_H #define ASSET_DATASET_H diff --git a/src/proc/asset/db.hpp b/src/proc/asset/db.hpp index 3da42bfde..ec116e5a6 100644 --- a/src/proc/asset/db.hpp +++ b/src/proc/asset/db.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ASSET_DB_H #define ASSET_DB_H diff --git a/src/proc/asset/effect.cpp b/src/proc/asset/effect.cpp index 4230177c3..ebefd30c3 100644 --- a/src/proc/asset/effect.cpp +++ b/src/proc/asset/effect.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/asset/effect.hpp" namespace proc { diff --git a/src/proc/asset/effect.hpp b/src/proc/asset/effect.hpp index fa9eed8fa..94adfea21 100644 --- a/src/proc/asset/effect.hpp +++ b/src/proc/asset/effect.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ASSET_EFFECT_H #define ASSET_EFFECT_H diff --git a/src/proc/asset/inventory.hpp b/src/proc/asset/inventory.hpp index 1c86f7c9a..35944f934 100644 --- a/src/proc/asset/inventory.hpp +++ b/src/proc/asset/inventory.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ASSET_INVENTORY_H #define ASSET_INVENTORY_H diff --git a/src/proc/asset/media.cpp b/src/proc/asset/media.cpp index 8a35e6cab..cacee9c1d 100644 --- a/src/proc/asset/media.cpp +++ b/src/proc/asset/media.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/error.hpp" #include "proc/common.hpp" #include "proc/assetmanager.hpp" diff --git a/src/proc/asset/meta.cpp b/src/proc/asset/meta.cpp index a62cdfd5e..f9ccdea7e 100644 --- a/src/proc/asset/meta.cpp +++ b/src/proc/asset/meta.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/assetmanager.hpp" #include "proc/asset/meta.hpp" #include "lib/util.hpp" diff --git a/src/proc/asset/meta/time-grid.cpp b/src/proc/asset/meta/time-grid.cpp index a56e89b5e..c79e74ed3 100644 --- a/src/proc/asset/meta/time-grid.cpp +++ b/src/proc/asset/meta/time-grid.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/asset/meta/time-grid.hpp" #include "proc/asset/struct-scheme.hpp" #include "proc/assetmanager.hpp" diff --git a/src/proc/asset/pipe.cpp b/src/proc/asset/pipe.cpp index f66b0ca53..340a104f8 100644 --- a/src/proc/asset/pipe.cpp +++ b/src/proc/asset/pipe.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/asset/pipe.hpp" #include "proc/assetmanager.hpp" #include "lib/util.hpp" diff --git a/src/proc/asset/pipe.hpp b/src/proc/asset/pipe.hpp index 082aa7164..f848cf77b 100644 --- a/src/proc/asset/pipe.hpp +++ b/src/proc/asset/pipe.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ASSET_PIPE_H #define ASSET_PIPE_H diff --git a/src/proc/asset/preview.cpp b/src/proc/asset/preview.cpp index c27879f02..dbab270c0 100644 --- a/src/proc/asset/preview.cpp +++ b/src/proc/asset/preview.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/asset/preview.hpp" namespace proc { diff --git a/src/proc/asset/preview.hpp b/src/proc/asset/preview.hpp index f576e1de2..7a1428d61 100644 --- a/src/proc/asset/preview.hpp +++ b/src/proc/asset/preview.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ASSET_PREVIEW_H #define ASSET_PREVIEW_H diff --git a/src/proc/asset/proc.cpp b/src/proc/asset/proc.cpp index 54bbde451..2045aac5e 100644 --- a/src/proc/asset/proc.cpp +++ b/src/proc/asset/proc.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/assetmanager.hpp" #include "proc/asset/proc.hpp" #include "lib/util.hpp" diff --git a/src/proc/asset/procpatt.cpp b/src/proc/asset/procpatt.cpp index 38bcc2275..c2bc0411f 100644 --- a/src/proc/asset/procpatt.cpp +++ b/src/proc/asset/procpatt.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/asset/procpatt.hpp" #include "proc/asset/proc.hpp" #include "proc/assetmanager.hpp" diff --git a/src/proc/asset/procpatt.hpp b/src/proc/asset/procpatt.hpp index b6202085a..23fe451d6 100644 --- a/src/proc/asset/procpatt.hpp +++ b/src/proc/asset/procpatt.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ASSET_PROCPATT_H #define ASSET_PROCPATT_H diff --git a/src/proc/asset/sequence.cpp b/src/proc/asset/sequence.cpp index 88735f3a6..917370a04 100644 --- a/src/proc/asset/sequence.cpp +++ b/src/proc/asset/sequence.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/asset/sequence.hpp" //#include "proc/mobject/session/fork.hpp" #include "proc/assetmanager.hpp" diff --git a/src/proc/asset/struct.cpp b/src/proc/asset/struct.cpp index 786be0299..00c9fe689 100644 --- a/src/proc/asset/struct.cpp +++ b/src/proc/asset/struct.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/asset/struct.hpp" #include "proc/assetmanager.hpp" #include "proc/config-resolver.hpp" diff --git a/src/proc/asset/timeline.cpp b/src/proc/asset/timeline.cpp index bf34d4f44..5f80a05e4 100644 --- a/src/proc/asset/timeline.cpp +++ b/src/proc/asset/timeline.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/asset/timeline.hpp" //#include "proc/mobject/session/fork.hpp" //#include "proc/mobject/placement.hpp" diff --git a/src/proc/asset/typed-lookup.cpp b/src/proc/asset/typed-lookup.cpp index 942090b04..bad753148 100644 --- a/src/proc/asset/typed-lookup.cpp +++ b/src/proc/asset/typed-lookup.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/asset/typed-id.hpp" diff --git a/src/proc/asset/unknown.cpp b/src/proc/asset/unknown.cpp index 131004e4f..f8559c63f 100644 --- a/src/proc/asset/unknown.cpp +++ b/src/proc/asset/unknown.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/asset/unknown.hpp" #include "lib/format-string.hpp" diff --git a/src/proc/asset/unknown.hpp b/src/proc/asset/unknown.hpp index 54f234c71..d025cb7ed 100644 --- a/src/proc/asset/unknown.hpp +++ b/src/proc/asset/unknown.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ASSET_UNKNOWN_H #define ASSET_UNKNOWN_H diff --git a/src/proc/asset/viewer.cpp b/src/proc/asset/viewer.cpp index 7c78f0754..3bb9fc81c 100644 --- a/src/proc/asset/viewer.cpp +++ b/src/proc/asset/viewer.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/asset/viewer.hpp" //#include "proc/mobject/session/fork.hpp" //#include "proc/mobject/placement.hpp" diff --git a/src/proc/assetmanager.cpp b/src/proc/assetmanager.cpp index 48fc92d1b..b0bc5ce83 100644 --- a/src/proc/assetmanager.cpp +++ b/src/proc/assetmanager.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/assetmanager.hpp" #include "proc/asset/db.hpp" diff --git a/src/proc/config-resolver.cpp b/src/proc/config-resolver.cpp index d7cb64575..971b3d437 100644 --- a/src/proc/config-resolver.cpp +++ b/src/proc/config-resolver.cpp @@ -22,6 +22,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/error.hpp" #include "proc/config-resolver.hpp" #include "proc/mobject/session/query/fake-configrules.hpp" diff --git a/src/proc/control/argument-erasure.hpp b/src/proc/control/argument-erasure.hpp index 6d74bdf9a..1a6431934 100644 --- a/src/proc/control/argument-erasure.hpp +++ b/src/proc/control/argument-erasure.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef CONTROL_ARGUMENT_ERASURE_H #define CONTROL_ARGUMENT_ERASURE_H diff --git a/src/proc/control/handling-pattern.cpp b/src/proc/control/handling-pattern.cpp index 032069d74..4d2e02f8d 100644 --- a/src/proc/control/handling-pattern.cpp +++ b/src/proc/control/handling-pattern.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/error.hpp" #include "proc/control/handling-pattern.hpp" diff --git a/src/proc/control/mediaimpllib.hpp b/src/proc/control/mediaimpllib.hpp index e01e3dcb2..39a44827a 100644 --- a/src/proc/control/mediaimpllib.hpp +++ b/src/proc/control/mediaimpllib.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef CONTROL_MEDIAIMPLLIB_H #define CONTROL_MEDIAIMPLLIB_H diff --git a/src/proc/control/pathmanager.cpp b/src/proc/control/pathmanager.cpp index 17870694a..1115745e1 100644 --- a/src/proc/control/pathmanager.cpp +++ b/src/proc/control/pathmanager.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/control/pathmanager.hpp" namespace proc { diff --git a/src/proc/control/pathmanager.hpp b/src/proc/control/pathmanager.hpp index 1c0e11722..3e320296c 100644 --- a/src/proc/control/pathmanager.hpp +++ b/src/proc/control/pathmanager.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef CONTROL_PATHMANAGER_H #define CONTROL_PATHMANAGER_H diff --git a/src/proc/control/proc-dispatcher.cpp b/src/proc/control/proc-dispatcher.cpp index a5755863a..5190222ce 100644 --- a/src/proc/control/proc-dispatcher.cpp +++ b/src/proc/control/proc-dispatcher.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/control/proc-dispatcher.hpp" #include "proc/mobject/session.hpp" diff --git a/src/proc/control/stypemanager.cpp b/src/proc/control/stypemanager.cpp index bcfaa5fbe..8b080af5e 100644 --- a/src/proc/control/stypemanager.cpp +++ b/src/proc/control/stypemanager.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/common.hpp" #include "proc/control/stypemanager.hpp" #include "proc/control/styperegistry.hpp" diff --git a/src/proc/control/stypemanager.hpp b/src/proc/control/stypemanager.hpp index 81262a4ee..1557e8b3b 100644 --- a/src/proc/control/stypemanager.hpp +++ b/src/proc/control/stypemanager.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_CONTROL_STYPEMANAGER_H #define PROC_CONTROL_STYPEMANAGER_H diff --git a/src/proc/controllerfacade.cpp b/src/proc/controllerfacade.cpp index 84076b44e..911b77c6f 100644 --- a/src/proc/controllerfacade.cpp +++ b/src/proc/controllerfacade.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/controllerfacade.hpp" namespace proc_interface { diff --git a/src/proc/controllerfacade.hpp b/src/proc/controllerfacade.hpp index e7f2c95c2..f8e2819ac 100644 --- a/src/proc/controllerfacade.hpp +++ b/src/proc/controllerfacade.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_INTERFACE_CONTROLLERFACADE_H #define PROC_INTERFACE_CONTROLLERFACADE_H diff --git a/src/proc/engine/buffer-local-key.hpp b/src/proc/engine/buffer-local-key.hpp index 5f93d1aaa..7b4c8d063 100644 --- a/src/proc/engine/buffer-local-key.hpp +++ b/src/proc/engine/buffer-local-key.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_ENGINE_BUFFR_LOCAL_KEY_H #define PROC_ENGINE_BUFFR_LOCAL_KEY_H diff --git a/src/proc/engine/buffer-provider.cpp b/src/proc/engine/buffer-provider.cpp index e4224556a..8727cdcab 100644 --- a/src/proc/engine/buffer-provider.cpp +++ b/src/proc/engine/buffer-provider.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/error.hpp" #include "proc/engine/buffer-provider.hpp" #include "proc/engine/buffer-metadata.hpp" diff --git a/src/proc/engine/bufftable-obsolete.hpp b/src/proc/engine/bufftable-obsolete.hpp index 665726804..f484e0f33 100644 --- a/src/proc/engine/bufftable-obsolete.hpp +++ b/src/proc/engine/bufftable-obsolete.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ENGINE_BUFFHTABLE_OBSOLETE_H #define ENGINE_BUFFHTABLE_OBSOLETE_H diff --git a/src/proc/engine/bufftable.hpp b/src/proc/engine/bufftable.hpp index 14ea61977..4de5d0ce8 100644 --- a/src/proc/engine/bufftable.hpp +++ b/src/proc/engine/bufftable.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ENGINE_BUFFHTABLE_H #define ENGINE_BUFFHTABLE_H diff --git a/src/proc/engine/calc-plan-continuation.cpp b/src/proc/engine/calc-plan-continuation.cpp index 9c72a0629..dc07e0bc1 100644 --- a/src/proc/engine/calc-plan-continuation.cpp +++ b/src/proc/engine/calc-plan-continuation.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/engine/calc-plan-continuation.hpp" #include "proc/engine/frame-coord.hpp" #include "proc/engine/job-ticket.hpp" diff --git a/src/proc/engine/calc-plan-continuation.hpp b/src/proc/engine/calc-plan-continuation.hpp index 47f8388ac..e8e4bd104 100644 --- a/src/proc/engine/calc-plan-continuation.hpp +++ b/src/proc/engine/calc-plan-continuation.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_ENGINE_CALC_PLAN_CONTINUATION_H #define PROC_ENGINE_CALC_PLAN_CONTINUATION_H diff --git a/src/proc/engine/calc-stream.hpp b/src/proc/engine/calc-stream.hpp index 9713b4491..57125399a 100644 --- a/src/proc/engine/calc-stream.hpp +++ b/src/proc/engine/calc-stream.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_ENGINE_CALC_STREAM_H #define PROC_ENGINE_CALC_STREAM_H diff --git a/src/proc/engine/diagnostic-buffer-provider.cpp b/src/proc/engine/diagnostic-buffer-provider.cpp index 3258e2f86..1fbd10b37 100644 --- a/src/proc/engine/diagnostic-buffer-provider.cpp +++ b/src/proc/engine/diagnostic-buffer-provider.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/error.hpp" #include "lib/meta/function.hpp" diff --git a/src/proc/engine/dispatch-table.cpp b/src/proc/engine/dispatch-table.cpp index ef92d2236..8eca0c8ff 100644 --- a/src/proc/engine/dispatch-table.cpp +++ b/src/proc/engine/dispatch-table.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/engine/dispatch-table.hpp" //#include "lib/frameid.hpp" //#include "proc/state.hpp" diff --git a/src/proc/engine/dispatch-table.hpp b/src/proc/engine/dispatch-table.hpp index 57b3324e7..8599f4e67 100644 --- a/src/proc/engine/dispatch-table.hpp +++ b/src/proc/engine/dispatch-table.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_ENGINE_DISPATCH_TABLE_H #define PROC_ENGINE_DISPATCH_TABLE_H diff --git a/src/proc/engine/dispatcher.cpp b/src/proc/engine/dispatcher.cpp index f79042c9e..4cc9c3699 100644 --- a/src/proc/engine/dispatcher.cpp +++ b/src/proc/engine/dispatcher.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/engine/dispatcher.hpp" //#include "lib/frameid.hpp" //#include "proc/state.hpp" diff --git a/src/proc/engine/dispatcher.hpp b/src/proc/engine/dispatcher.hpp index 91d2d0ce6..b409e08da 100644 --- a/src/proc/engine/dispatcher.hpp +++ b/src/proc/engine/dispatcher.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_ENGINE_DISPATCHER_H #define PROC_ENGINE_DISPATCHER_H diff --git a/src/proc/engine/engine-service-mock.cpp b/src/proc/engine/engine-service-mock.cpp index 899e21af9..c6dfef556 100644 --- a/src/proc/engine/engine-service-mock.cpp +++ b/src/proc/engine/engine-service-mock.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/engine/engine-service-mock.hpp" #include "proc/engine/worker/dummy-tick.hpp" diff --git a/src/proc/engine/engine-service.cpp b/src/proc/engine/engine-service.cpp index c936e4904..15244308b 100644 --- a/src/proc/engine/engine-service.cpp +++ b/src/proc/engine/engine-service.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/engine/engine-service.hpp" #include "lib/itertools.hpp" diff --git a/src/proc/engine/frame-coord.hpp b/src/proc/engine/frame-coord.hpp index 49a9550c5..373b611a5 100644 --- a/src/proc/engine/frame-coord.hpp +++ b/src/proc/engine/frame-coord.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_ENGINE_FRAME_COORD_H #define PROC_ENGINE_FRAME_COORD_H diff --git a/src/proc/engine/job-ticket.hpp b/src/proc/engine/job-ticket.hpp index f3667eaa4..468e2a093 100644 --- a/src/proc/engine/job-ticket.hpp +++ b/src/proc/engine/job-ticket.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_ENGINE_JOB_TICKET_H #define PROC_ENGINE_JOB_TICKET_H diff --git a/src/proc/engine/link.cpp b/src/proc/engine/link.cpp index 0ee39458e..7f5f855c5 100644 --- a/src/proc/engine/link.cpp +++ b/src/proc/engine/link.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/engine/link.hpp" namespace proc { diff --git a/src/proc/engine/link.hpp b/src/proc/engine/link.hpp index ea9b17edb..7d769f1d4 100644 --- a/src/proc/engine/link.hpp +++ b/src/proc/engine/link.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ENGINE_LINK_H #define ENGINE_LINK_H diff --git a/src/proc/engine/mask.cpp b/src/proc/engine/mask.cpp index b341f51b9..69a132844 100644 --- a/src/proc/engine/mask.cpp +++ b/src/proc/engine/mask.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/engine/mask.hpp" namespace proc { diff --git a/src/proc/engine/mask.hpp b/src/proc/engine/mask.hpp index 364f370a8..dddc57a09 100644 --- a/src/proc/engine/mask.hpp +++ b/src/proc/engine/mask.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ENGINE_MASK_H #define ENGINE_MASK_H diff --git a/src/proc/engine/nodefactory.cpp b/src/proc/engine/nodefactory.cpp index 5812bf40a..ef03b5cea 100644 --- a/src/proc/engine/nodefactory.cpp +++ b/src/proc/engine/nodefactory.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/engine/nodefactory.hpp" #include "proc/mobject/session/effect.hpp" #include "lib/allocation-cluster.hpp" diff --git a/src/proc/engine/nodefactory.hpp b/src/proc/engine/nodefactory.hpp index 63b5ca719..667e3a85c 100644 --- a/src/proc/engine/nodefactory.hpp +++ b/src/proc/engine/nodefactory.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ENGINE_NODEFACTORY_H #define ENGINE_NODEFACTORY_H diff --git a/src/proc/engine/nodewiring.cpp b/src/proc/engine/nodewiring.cpp index c6d596ba0..5267aa932 100644 --- a/src/proc/engine/nodewiring.cpp +++ b/src/proc/engine/nodewiring.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/engine/procnode.hpp" #include "proc/engine/nodewiring.hpp" #include "proc/engine/nodeoperation.hpp" diff --git a/src/proc/engine/nodewiring.hpp b/src/proc/engine/nodewiring.hpp index d420643f7..a8e8ad4ce 100644 --- a/src/proc/engine/nodewiring.hpp +++ b/src/proc/engine/nodewiring.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ENGINE_NODEWIRING_H #define ENGINE_NODEWIRING_H diff --git a/src/proc/engine/pluginadapter.cpp b/src/proc/engine/pluginadapter.cpp index 5bbc144e8..696e5d6c3 100644 --- a/src/proc/engine/pluginadapter.cpp +++ b/src/proc/engine/pluginadapter.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/engine/pluginadapter.hpp" namespace proc { diff --git a/src/proc/engine/pluginadapter.hpp b/src/proc/engine/pluginadapter.hpp index 38d7152a3..49bee21f5 100644 --- a/src/proc/engine/pluginadapter.hpp +++ b/src/proc/engine/pluginadapter.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ENGINE_PLUGINADAPTER_H #define ENGINE_PLUGINADAPTER_H diff --git a/src/proc/engine/render-invocation.cpp b/src/proc/engine/render-invocation.cpp index adf7d67ac..922507e13 100644 --- a/src/proc/engine/render-invocation.cpp +++ b/src/proc/engine/render-invocation.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/engine/render-invocation.hpp" #include "proc/engine/stateproxy.hpp" diff --git a/src/proc/engine/renderengine.cpp b/src/proc/engine/renderengine.cpp index 706a87e07..b786e8cb8 100644 --- a/src/proc/engine/renderengine.cpp +++ b/src/proc/engine/renderengine.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/engine/renderengine.hpp" namespace proc { diff --git a/src/proc/engine/renderengine.hpp b/src/proc/engine/renderengine.hpp index abe036bef..b743af9f9 100644 --- a/src/proc/engine/renderengine.hpp +++ b/src/proc/engine/renderengine.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ENGINE_RENDERENGINE_H #define ENGINE_RENDERENGINE_H diff --git a/src/proc/engine/rendergraph.cpp b/src/proc/engine/rendergraph.cpp index 0c100fde3..83cd52170 100644 --- a/src/proc/engine/rendergraph.cpp +++ b/src/proc/engine/rendergraph.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/engine/rendergraph.hpp" #include "lib/frameid.hpp" #include "proc/state.hpp" diff --git a/src/proc/engine/rendergraph.hpp b/src/proc/engine/rendergraph.hpp index 63c039e0f..f2a29114c 100644 --- a/src/proc/engine/rendergraph.hpp +++ b/src/proc/engine/rendergraph.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ENGINE_RENDERGRAPH_H #define ENGINE_RENDERGRAPH_H diff --git a/src/proc/engine/source.cpp b/src/proc/engine/source.cpp index 477bc768e..30f6f38a3 100644 --- a/src/proc/engine/source.cpp +++ b/src/proc/engine/source.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/engine/source.hpp" namespace proc { diff --git a/src/proc/engine/source.hpp b/src/proc/engine/source.hpp index fedeb1784..5b10fc1f6 100644 --- a/src/proc/engine/source.hpp +++ b/src/proc/engine/source.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ENGINE_SOURCE_H #define ENGINE_SOURCE_H diff --git a/src/proc/engine/stateproxy.cpp b/src/proc/engine/stateproxy.cpp index c62a468a5..438553beb 100644 --- a/src/proc/engine/stateproxy.cpp +++ b/src/proc/engine/stateproxy.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/engine/stateproxy.hpp" namespace proc { diff --git a/src/proc/engine/stateproxy.hpp b/src/proc/engine/stateproxy.hpp index 269e47dae..19bacd5c6 100644 --- a/src/proc/engine/stateproxy.hpp +++ b/src/proc/engine/stateproxy.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef ENGINE_STATEPROXY_H #define ENGINE_STATEPROXY_H diff --git a/src/proc/engine/time-anchor.hpp b/src/proc/engine/time-anchor.hpp index 2cded87ea..e83f968db 100644 --- a/src/proc/engine/time-anchor.hpp +++ b/src/proc/engine/time-anchor.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_ENGINE_TIME_ANCHOR_H #define PROC_ENGINE_TIME_ANCHOR_H diff --git a/src/proc/engine/tracking-heap-block-provider.cpp b/src/proc/engine/tracking-heap-block-provider.cpp index 3ca8d68d5..1060b6a71 100644 --- a/src/proc/engine/tracking-heap-block-provider.cpp +++ b/src/proc/engine/tracking-heap-block-provider.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/error.hpp" #include "include/logging.h" //#include "lib/meta/function.hpp" diff --git a/src/proc/engine/worker/dummy-image-generator.cpp b/src/proc/engine/worker/dummy-image-generator.cpp index 577da2f94..93b20ead6 100644 --- a/src/proc/engine/worker/dummy-image-generator.cpp +++ b/src/proc/engine/worker/dummy-image-generator.cpp @@ -22,6 +22,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/engine/worker/dummy-image-generator.hpp" diff --git a/src/proc/external/libgavl.cpp b/src/proc/external/libgavl.cpp index 637e7c559..372839dbb 100644 --- a/src/proc/external/libgavl.cpp +++ b/src/proc/external/libgavl.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/common.hpp" #include "proc/external/libgavl.hpp" #include "proc/control/stypemanager.hpp" diff --git a/src/proc/external/libgavl.hpp b/src/proc/external/libgavl.hpp index 632a76c66..dc25134b1 100644 --- a/src/proc/external/libgavl.hpp +++ b/src/proc/external/libgavl.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_EXTERNAL_LIBGAVL_H #define PROC_EXTERNAL_LIBGAVL_H diff --git a/src/proc/facade.cpp b/src/proc/facade.cpp index a2a1d02a5..1375b27dd 100644 --- a/src/proc/facade.cpp +++ b/src/proc/facade.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/facade.hpp" #include "lib/depend.hpp" #include "proc/play/output-director.hpp" diff --git a/src/proc/mobject/builder/assembler.cpp b/src/proc/mobject/builder/assembler.cpp index 3ea5a0bd7..12c127b3f 100644 --- a/src/proc/mobject/builder/assembler.cpp +++ b/src/proc/mobject/builder/assembler.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/builder/assembler.hpp" namespace proc { diff --git a/src/proc/mobject/builder/assembler.hpp b/src/proc/mobject/builder/assembler.hpp index 095052581..8431791d5 100644 --- a/src/proc/mobject/builder/assembler.hpp +++ b/src/proc/mobject/builder/assembler.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_BUILDER_ASSEMBLER_H #define MOBJECT_BUILDER_ASSEMBLER_H diff --git a/src/proc/mobject/builder/common.hpp b/src/proc/mobject/builder/common.hpp index 35d51c2a5..0a792c0ac 100644 --- a/src/proc/mobject/builder/common.hpp +++ b/src/proc/mobject/builder/common.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_BUILDER_COMMON_H #define MOBJECT_BUILDER_COMMON_H diff --git a/src/proc/mobject/builder/conmanager.cpp b/src/proc/mobject/builder/conmanager.cpp index 082512d90..8b2e57024 100644 --- a/src/proc/mobject/builder/conmanager.cpp +++ b/src/proc/mobject/builder/conmanager.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/builder/conmanager.hpp" #include "proc/control/stypemanager.hpp" diff --git a/src/proc/mobject/builder/conmanager.hpp b/src/proc/mobject/builder/conmanager.hpp index 6e9c850c0..74650e11a 100644 --- a/src/proc/mobject/builder/conmanager.hpp +++ b/src/proc/mobject/builder/conmanager.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_MOBJECT_BUILDER_CONMANAGER_H #define PROC_MOBJECT_BUILDER_CONMANAGER_H diff --git a/src/proc/mobject/builder/mould.hpp b/src/proc/mobject/builder/mould.hpp index e1bf5cb73..f6b702185 100644 --- a/src/proc/mobject/builder/mould.hpp +++ b/src/proc/mobject/builder/mould.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_BUILDER_MOULD_H #define MOBJECT_BUILDER_MOULD_H diff --git a/src/proc/mobject/builder/nodecreatortool.cpp b/src/proc/mobject/builder/nodecreatortool.cpp index 7f617f28e..f54aa2aa8 100644 --- a/src/proc/mobject/builder/nodecreatortool.cpp +++ b/src/proc/mobject/builder/nodecreatortool.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/builder/nodecreatortool.hpp" diff --git a/src/proc/mobject/builder/nodecreatortool.hpp b/src/proc/mobject/builder/nodecreatortool.hpp index c808dce2e..b585d3295 100644 --- a/src/proc/mobject/builder/nodecreatortool.hpp +++ b/src/proc/mobject/builder/nodecreatortool.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_BUILDER_NODECREATORTOOL_H #define MOBJECT_BUILDER_NODECREATORTOOL_H diff --git a/src/proc/mobject/builder/operationpoint.cpp b/src/proc/mobject/builder/operationpoint.cpp index db1165ff1..0d51ac960 100644 --- a/src/proc/mobject/builder/operationpoint.cpp +++ b/src/proc/mobject/builder/operationpoint.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/builder/operationpoint.hpp" #include "proc/engine/procnode.hpp" #include "proc/asset/media.hpp" diff --git a/src/proc/mobject/builder/operationpoint.hpp b/src/proc/mobject/builder/operationpoint.hpp index 09b54fd81..150b0d063 100644 --- a/src/proc/mobject/builder/operationpoint.hpp +++ b/src/proc/mobject/builder/operationpoint.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_BUILDER_OPERATIONPOINT_H #define MOBJECT_BUILDER_OPERATIONPOINT_H diff --git a/src/proc/mobject/builder/renderstate.hpp b/src/proc/mobject/builder/renderstate.hpp index 935aaab7e..caa91f757 100644 --- a/src/proc/mobject/builder/renderstate.hpp +++ b/src/proc/mobject/builder/renderstate.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_BUILDER_RENDERSTATE_H #define MOBJECT_BUILDER_RENDERSTATE_H diff --git a/src/proc/mobject/builder/segmentation-tool.cpp b/src/proc/mobject/builder/segmentation-tool.cpp index 895a2fe53..b71d5bece 100644 --- a/src/proc/mobject/builder/segmentation-tool.cpp +++ b/src/proc/mobject/builder/segmentation-tool.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/builder/segmentation-tool.hpp" diff --git a/src/proc/mobject/builder/segmentation-tool.hpp b/src/proc/mobject/builder/segmentation-tool.hpp index 720938cc5..645ddf115 100644 --- a/src/proc/mobject/builder/segmentation-tool.hpp +++ b/src/proc/mobject/builder/segmentation-tool.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_BUILDER_SEGMENTATION_TOOL_H #define MOBJECT_BUILDER_SEGMENTATION_TOOL_H diff --git a/src/proc/mobject/builder/toolfactory.cpp b/src/proc/mobject/builder/toolfactory.cpp index b116ea62f..b7d75c775 100644 --- a/src/proc/mobject/builder/toolfactory.cpp +++ b/src/proc/mobject/builder/toolfactory.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/builder/toolfactory.hpp" #include "lib/util.hpp" diff --git a/src/proc/mobject/builder/toolfactory.hpp b/src/proc/mobject/builder/toolfactory.hpp index b30b90907..56cba1070 100644 --- a/src/proc/mobject/builder/toolfactory.hpp +++ b/src/proc/mobject/builder/toolfactory.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_BUILDER_TOOLFACTORY_H #define MOBJECT_BUILDER_TOOLFACTORY_H diff --git a/src/proc/mobject/builder/wiringrequest.hpp b/src/proc/mobject/builder/wiringrequest.hpp index 25f908994..94aea841e 100644 --- a/src/proc/mobject/builder/wiringrequest.hpp +++ b/src/proc/mobject/builder/wiringrequest.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_BUILDER_WIRINGREQUEST_H #define MOBJECT_BUILDER_WIRINGREQUEST_H diff --git a/src/proc/mobject/builderfacade.cpp b/src/proc/mobject/builderfacade.cpp index ec4c86682..e5469d87d 100644 --- a/src/proc/mobject/builderfacade.cpp +++ b/src/proc/mobject/builderfacade.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/builder/common.hpp" #include "proc/mobject/builderfacade.hpp" diff --git a/src/proc/mobject/builderfacade.hpp b/src/proc/mobject/builderfacade.hpp index c58ce3692..b67562cf4 100644 --- a/src/proc/mobject/builderfacade.hpp +++ b/src/proc/mobject/builderfacade.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_BUILDERFACADE_H #define MOBJECT_BUILDERFACADE_H diff --git a/src/proc/mobject/explicitplacement.hpp b/src/proc/mobject/explicitplacement.hpp index 558be04f6..d2492b98d 100644 --- a/src/proc/mobject/explicitplacement.hpp +++ b/src/proc/mobject/explicitplacement.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_EXPLICITPLACEMENT_H #define MOBJECT_EXPLICITPLACEMENT_H diff --git a/src/proc/mobject/interpolator.cpp b/src/proc/mobject/interpolator.cpp index ca061f37e..1961e04e0 100644 --- a/src/proc/mobject/interpolator.cpp +++ b/src/proc/mobject/interpolator.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/interpolator.hpp" namespace proc { diff --git a/src/proc/mobject/interpolator.hpp b/src/proc/mobject/interpolator.hpp index ec70070f5..0a288c279 100644 --- a/src/proc/mobject/interpolator.hpp +++ b/src/proc/mobject/interpolator.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_INTERPOLATOR_H #define MOBJECT_INTERPOLATOR_H diff --git a/src/proc/mobject/mobject.cpp b/src/proc/mobject/mobject.cpp index 48c187141..3c6c37c69 100644 --- a/src/proc/mobject/mobject.cpp +++ b/src/proc/mobject/mobject.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/mobject.hpp" #include "proc/mobject/session/mobjectfactory.hpp" #include "lib/time/timevalue.hpp" diff --git a/src/proc/mobject/mobject.hpp b/src/proc/mobject/mobject.hpp index cf0ce6217..723a4fe40 100644 --- a/src/proc/mobject/mobject.hpp +++ b/src/proc/mobject/mobject.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_MOBJECT_H #define MOBJECT_MOBJECT_H diff --git a/src/proc/mobject/output-designation.hpp b/src/proc/mobject/output-designation.hpp index c06cc34b4..9c3412c46 100644 --- a/src/proc/mobject/output-designation.hpp +++ b/src/proc/mobject/output-designation.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_MOBJECT_OUTPUT_DESIGNATION_H #define PROC_MOBJECT_OUTPUT_DESIGNATION_H diff --git a/src/proc/mobject/parameter.cpp b/src/proc/mobject/parameter.cpp index 5a00644ce..6c0db28fd 100644 --- a/src/proc/mobject/parameter.cpp +++ b/src/proc/mobject/parameter.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/error.hpp" #include "proc/mobject/parameter.hpp" #include "proc/mobject/paramprovider.hpp" diff --git a/src/proc/mobject/parameter.hpp b/src/proc/mobject/parameter.hpp index fa256d0f6..320a3c2f4 100644 --- a/src/proc/mobject/parameter.hpp +++ b/src/proc/mobject/parameter.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_MOBJECT_PARAMETER_H #define PROC_MOBJECT_PARAMETER_H diff --git a/src/proc/mobject/paramprovider.cpp b/src/proc/mobject/paramprovider.cpp index 9bdeeb452..b83347da5 100644 --- a/src/proc/mobject/paramprovider.cpp +++ b/src/proc/mobject/paramprovider.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/paramprovider.hpp" #include "proc/mobject/parameter.hpp" #include "proc/mobject/interpolator.hpp" diff --git a/src/proc/mobject/paramprovider.hpp b/src/proc/mobject/paramprovider.hpp index 3be0b2206..82261db32 100644 --- a/src/proc/mobject/paramprovider.hpp +++ b/src/proc/mobject/paramprovider.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_PARAMPROVIDER_H #define MOBJECT_PARAMPROVIDER_H diff --git a/src/proc/mobject/placement.cpp b/src/proc/mobject/placement.cpp index 4f97a3a1a..e9ac34b46 100644 --- a/src/proc/mobject/placement.cpp +++ b/src/proc/mobject/placement.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/placement.hpp" #include "proc/mobject/explicitplacement.hpp" #include "proc/mobject/mobject.hpp" diff --git a/src/proc/mobject/session/abstractmo.cpp b/src/proc/mobject/session/abstractmo.cpp index aaba3176d..facf25532 100644 --- a/src/proc/mobject/session/abstractmo.cpp +++ b/src/proc/mobject/session/abstractmo.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/abstractmo.hpp" #include "lib/format-string.hpp" #include "lib/util.hpp" diff --git a/src/proc/mobject/session/abstractmo.hpp b/src/proc/mobject/session/abstractmo.hpp index 7c6b9ef70..5c300ca27 100644 --- a/src/proc/mobject/session/abstractmo.hpp +++ b/src/proc/mobject/session/abstractmo.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_SESSION_ABSTRACTMO_H #define MOBJECT_SESSION_ABSTRACTMO_H diff --git a/src/proc/mobject/session/allocation.cpp b/src/proc/mobject/session/allocation.cpp index 5a8b50e61..9d94b2701 100644 --- a/src/proc/mobject/session/allocation.cpp +++ b/src/proc/mobject/session/allocation.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/allocation.hpp" namespace proc { diff --git a/src/proc/mobject/session/allocation.hpp b/src/proc/mobject/session/allocation.hpp index 5f263310d..afb208e23 100644 --- a/src/proc/mobject/session/allocation.hpp +++ b/src/proc/mobject/session/allocation.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_MOBJECT_SESSION_ALLOCATION_H #define PROC_MOBJECT_SESSION_ALLOCATION_H diff --git a/src/proc/mobject/session/auto.cpp b/src/proc/mobject/session/auto.cpp index 54032b633..a350124bc 100644 --- a/src/proc/mobject/session/auto.cpp +++ b/src/proc/mobject/session/auto.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/auto.hpp" namespace proc { diff --git a/src/proc/mobject/session/auto.hpp b/src/proc/mobject/session/auto.hpp index 152baa851..001e13ff7 100644 --- a/src/proc/mobject/session/auto.hpp +++ b/src/proc/mobject/session/auto.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_MOBJECT_SESSION_AUTO_H #define PROC_MOBJECT_SESSION_AUTO_H diff --git a/src/proc/mobject/session/binding.cpp b/src/proc/mobject/session/binding.cpp index acc6dee79..6abc12ce8 100644 --- a/src/proc/mobject/session/binding.cpp +++ b/src/proc/mobject/session/binding.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/binding.hpp" #include "proc/asset/sequence.hpp" diff --git a/src/proc/mobject/session/binding.hpp b/src/proc/mobject/session/binding.hpp index 089b946b1..de23ac956 100644 --- a/src/proc/mobject/session/binding.hpp +++ b/src/proc/mobject/session/binding.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_MOBJECT_SESSION_BINDING_H #define PROC_MOBJECT_SESSION_BINDING_H diff --git a/src/proc/mobject/session/bus-mo.cpp b/src/proc/mobject/session/bus-mo.cpp index ac06ee6c0..e61fe8893 100644 --- a/src/proc/mobject/session/bus-mo.cpp +++ b/src/proc/mobject/session/bus-mo.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/bus-mo.hpp" namespace proc { diff --git a/src/proc/mobject/session/bus-mo.hpp b/src/proc/mobject/session/bus-mo.hpp index 76ea650c4..9044058d1 100644 --- a/src/proc/mobject/session/bus-mo.hpp +++ b/src/proc/mobject/session/bus-mo.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_MOBJECT_SESSION_BUS_MO_H #define PROC_MOBJECT_SESSION_BUS_MO_H diff --git a/src/proc/mobject/session/clip.cpp b/src/proc/mobject/session/clip.cpp index 1461be405..5f2479c41 100644 --- a/src/proc/mobject/session/clip.cpp +++ b/src/proc/mobject/session/clip.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/clip.hpp" #include "proc/assetmanager.hpp" #include "proc/asset/media.hpp" diff --git a/src/proc/mobject/session/clip.hpp b/src/proc/mobject/session/clip.hpp index c01e37e1f..0ddd11500 100644 --- a/src/proc/mobject/session/clip.hpp +++ b/src/proc/mobject/session/clip.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_MOBJECT_SESSION_CLIP_H #define PROC_MOBJECT_SESSION_CLIP_H diff --git a/src/proc/mobject/session/constraint.cpp b/src/proc/mobject/session/constraint.cpp index 1bedefbe1..6f29e9dd9 100644 --- a/src/proc/mobject/session/constraint.cpp +++ b/src/proc/mobject/session/constraint.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/constraint.hpp" namespace proc { diff --git a/src/proc/mobject/session/constraint.hpp b/src/proc/mobject/session/constraint.hpp index 827a48fc1..fec415780 100644 --- a/src/proc/mobject/session/constraint.hpp +++ b/src/proc/mobject/session/constraint.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_MOBJECT_SESSION_CONSTRAINT_H #define PROC_MOBJECT_SESSION_CONSTRAINT_H diff --git a/src/proc/mobject/session/effect.cpp b/src/proc/mobject/session/effect.cpp index fe78b195b..4d2916f10 100644 --- a/src/proc/mobject/session/effect.cpp +++ b/src/proc/mobject/session/effect.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/effect.hpp" namespace proc { diff --git a/src/proc/mobject/session/effect.hpp b/src/proc/mobject/session/effect.hpp index c1a84b31b..870a7e6c8 100644 --- a/src/proc/mobject/session/effect.hpp +++ b/src/proc/mobject/session/effect.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_MOBJECT_SESSION_EFFECT_H #define PROC_MOBJECT_SESSION_EFFECT_H diff --git a/src/proc/mobject/session/element-query.hpp b/src/proc/mobject/session/element-query.hpp index 486c737c9..89e4e720b 100644 --- a/src/proc/mobject/session/element-query.hpp +++ b/src/proc/mobject/session/element-query.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_MOBJECT_SESSION_ELEMENT_QUERY_H #define PROC_MOBJECT_SESSION_ELEMENT_QUERY_H diff --git a/src/proc/mobject/session/fixedlocation.cpp b/src/proc/mobject/session/fixedlocation.cpp index 59bd299b9..fd22b04dd 100644 --- a/src/proc/mobject/session/fixedlocation.cpp +++ b/src/proc/mobject/session/fixedlocation.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/fixedlocation.hpp" namespace proc { diff --git a/src/proc/mobject/session/fixedlocation.hpp b/src/proc/mobject/session/fixedlocation.hpp index cab2b0698..6443748bc 100644 --- a/src/proc/mobject/session/fixedlocation.hpp +++ b/src/proc/mobject/session/fixedlocation.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_MOBJECT_SESSION_FIXEDLOCATION_H #define PROC_MOBJECT_SESSION_FIXEDLOCATION_H diff --git a/src/proc/mobject/session/fixture.cpp b/src/proc/mobject/session/fixture.cpp index 3f4aac79e..eb13a8263 100644 --- a/src/proc/mobject/session/fixture.cpp +++ b/src/proc/mobject/session/fixture.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/fixture.hpp" #include "include/logging.h" diff --git a/src/proc/mobject/session/fixture.hpp b/src/proc/mobject/session/fixture.hpp index 4b40b3b93..de32267e3 100644 --- a/src/proc/mobject/session/fixture.hpp +++ b/src/proc/mobject/session/fixture.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_SESSION_FIXTURE_H #define MOBJECT_SESSION_FIXTURE_H diff --git a/src/proc/mobject/session/fork.cpp b/src/proc/mobject/session/fork.cpp index c5e800b19..40881fdda 100644 --- a/src/proc/mobject/session/fork.cpp +++ b/src/proc/mobject/session/fork.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/fork.hpp" diff --git a/src/proc/mobject/session/fork.hpp b/src/proc/mobject/session/fork.hpp index 31eec9444..9afa05fe8 100644 --- a/src/proc/mobject/session/fork.hpp +++ b/src/proc/mobject/session/fork.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_SESSION_FORK_H #define MOBJECT_SESSION_FORK_H diff --git a/src/proc/mobject/session/generator-mo.cpp b/src/proc/mobject/session/generator-mo.cpp index a57ff41c9..325475c43 100644 --- a/src/proc/mobject/session/generator-mo.cpp +++ b/src/proc/mobject/session/generator-mo.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/generator-mo.hpp" //#include "proc/assetmanager.hpp" //#include "proc/asset/media.hpp" diff --git a/src/proc/mobject/session/generator-mo.hpp b/src/proc/mobject/session/generator-mo.hpp index 8df786d81..f6bf43b33 100644 --- a/src/proc/mobject/session/generator-mo.hpp +++ b/src/proc/mobject/session/generator-mo.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_MOBJECT_SESSION_GENERATOR_MO_H #define PROC_MOBJECT_SESSION_GENERATOR_MO_H diff --git a/src/proc/mobject/session/label.cpp b/src/proc/mobject/session/label.cpp index f14c1520b..11db127ab 100644 --- a/src/proc/mobject/session/label.cpp +++ b/src/proc/mobject/session/label.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/label.hpp" #include "lib/util.hpp" diff --git a/src/proc/mobject/session/label.hpp b/src/proc/mobject/session/label.hpp index 74c7e0bae..91f1a5916 100644 --- a/src/proc/mobject/session/label.hpp +++ b/src/proc/mobject/session/label.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_MOBJECT_SESSION_LABEL_H #define PROC_MOBJECT_SESSION_LABEL_H diff --git a/src/proc/mobject/session/locatingpin.cpp b/src/proc/mobject/session/locatingpin.cpp index de85b98f3..04e20d782 100644 --- a/src/proc/mobject/session/locatingpin.cpp +++ b/src/proc/mobject/session/locatingpin.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/mobject.hpp" #include "proc/mobject/placement.hpp" #include "proc/mobject/session/locatingpin.hpp" diff --git a/src/proc/mobject/session/meta.cpp b/src/proc/mobject/session/meta.cpp index 275e585aa..0c9a61983 100644 --- a/src/proc/mobject/session/meta.cpp +++ b/src/proc/mobject/session/meta.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/meta.hpp" namespace proc { diff --git a/src/proc/mobject/session/meta.hpp b/src/proc/mobject/session/meta.hpp index db49c9ed5..b9dedb698 100644 --- a/src/proc/mobject/session/meta.hpp +++ b/src/proc/mobject/session/meta.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_MOBJECT_SESSION_META_H #define PROC_MOBJECT_SESSION_META_H diff --git a/src/proc/mobject/session/mobjectfactory.cpp b/src/proc/mobject/session/mobjectfactory.cpp index 2a03d3224..3bca87f90 100644 --- a/src/proc/mobject/session/mobjectfactory.cpp +++ b/src/proc/mobject/session/mobjectfactory.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/mobjectfactory.hpp" #include "proc/mobject/session/root.hpp" #include "proc/mobject/session/clip.hpp" diff --git a/src/proc/mobject/session/mobjectfactory.hpp b/src/proc/mobject/session/mobjectfactory.hpp index 86a50b6f4..d50e5f771 100644 --- a/src/proc/mobject/session/mobjectfactory.hpp +++ b/src/proc/mobject/session/mobjectfactory.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_MOBJECT_SESSION_MOBJECTFACTORY_H #define PROC_MOBJECT_SESSION_MOBJECTFACTORY_H diff --git a/src/proc/mobject/session/placement-index-query-resolver.cpp b/src/proc/mobject/session/placement-index-query-resolver.cpp index 4c3678a5c..4a457c924 100644 --- a/src/proc/mobject/session/placement-index-query-resolver.cpp +++ b/src/proc/mobject/session/placement-index-query-resolver.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/placement-index-query-resolver.hpp" #include "proc/mobject/session/scope-query.hpp" #include "proc/mobject/placement.hpp" diff --git a/src/proc/mobject/session/plug.cpp b/src/proc/mobject/session/plug.cpp index 0e449c9fc..b01eef7d1 100644 --- a/src/proc/mobject/session/plug.cpp +++ b/src/proc/mobject/session/plug.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/plug.hpp" #include "proc/asset/pipe.hpp" diff --git a/src/proc/mobject/session/plug.hpp b/src/proc/mobject/session/plug.hpp index 315a582c0..86f1155a9 100644 --- a/src/proc/mobject/session/plug.hpp +++ b/src/proc/mobject/session/plug.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_SESSION_PLUG_H #define MOBJECT_SESSION_PLUG_H diff --git a/src/proc/mobject/session/query-focus-stack.hpp b/src/proc/mobject/session/query-focus-stack.hpp index e6c2e79c9..c6c9d1ef1 100644 --- a/src/proc/mobject/session/query-focus-stack.hpp +++ b/src/proc/mobject/session/query-focus-stack.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_SESSION_QUERY_FOCUS_STACK_H #define MOBJECT_SESSION_QUERY_FOCUS_STACK_H diff --git a/src/proc/mobject/session/query-focus.cpp b/src/proc/mobject/session/query-focus.cpp index 9e16a2812..a7465061e 100644 --- a/src/proc/mobject/session/query-focus.cpp +++ b/src/proc/mobject/session/query-focus.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/query-focus.hpp" #include "proc/mobject/mobject.hpp" #include "lib/format-string.hpp" diff --git a/src/proc/mobject/session/query-focus.hpp b/src/proc/mobject/session/query-focus.hpp index 8f68ca707..1158fa3a7 100644 --- a/src/proc/mobject/session/query-focus.hpp +++ b/src/proc/mobject/session/query-focus.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_SESSION_QUERY_FOCUS_H #define MOBJECT_SESSION_QUERY_FOCUS_H diff --git a/src/proc/mobject/session/query/fake-configrules.cpp b/src/proc/mobject/session/query/fake-configrules.cpp index 79747f2a3..a51e4cc91 100644 --- a/src/proc/mobject/session/query/fake-configrules.cpp +++ b/src/proc/mobject/session/query/fake-configrules.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/query/fake-configrules.hpp" #include "proc/mobject/session.hpp" diff --git a/src/proc/mobject/session/relativelocation.cpp b/src/proc/mobject/session/relativelocation.cpp index 1d40b67ca..f6633de8a 100644 --- a/src/proc/mobject/session/relativelocation.cpp +++ b/src/proc/mobject/session/relativelocation.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/relativelocation.hpp" #include "proc/mobject/mobject.hpp" diff --git a/src/proc/mobject/session/relativelocation.hpp b/src/proc/mobject/session/relativelocation.hpp index 09eb45bfe..15c71d1bf 100644 --- a/src/proc/mobject/session/relativelocation.hpp +++ b/src/proc/mobject/session/relativelocation.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_SESSION_RELATIVELOCATION_H #define MOBJECT_SESSION_RELATIVELOCATION_H diff --git a/src/proc/mobject/session/root.cpp b/src/proc/mobject/session/root.cpp index 1696b6e85..54a0b80dc 100644 --- a/src/proc/mobject/session/root.cpp +++ b/src/proc/mobject/session/root.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/root.hpp" #include "common/query/defs-manager.hpp" diff --git a/src/proc/mobject/session/root.hpp b/src/proc/mobject/session/root.hpp index 871bad337..16ed3991b 100644 --- a/src/proc/mobject/session/root.hpp +++ b/src/proc/mobject/session/root.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_MOBJECT_SESSION_ROOT_H #define PROC_MOBJECT_SESSION_ROOT_H diff --git a/src/proc/mobject/session/scope-locator.hpp b/src/proc/mobject/session/scope-locator.hpp index 1105c5b2a..c9fad72e8 100644 --- a/src/proc/mobject/session/scope-locator.hpp +++ b/src/proc/mobject/session/scope-locator.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_MOBJECT_SESSION_SCOPE_LOCATOR_H #define PROC_MOBJECT_SESSION_SCOPE_LOCATOR_H diff --git a/src/proc/mobject/session/scope-path.cpp b/src/proc/mobject/session/scope-path.cpp index 4ebc6bd28..fbbc744ad 100644 --- a/src/proc/mobject/session/scope-path.cpp +++ b/src/proc/mobject/session/scope-path.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "include/logging.h" #include "proc/mobject/session/scope-path.hpp" #include "proc/mobject/session/scope-locator.hpp" diff --git a/src/proc/mobject/session/scope.hpp b/src/proc/mobject/session/scope.hpp index a45ac7a74..322911287 100644 --- a/src/proc/mobject/session/scope.hpp +++ b/src/proc/mobject/session/scope.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_MOBJECT_SESSION_SCOPE_H #define PROC_MOBJECT_SESSION_SCOPE_H diff --git a/src/proc/mobject/session/segment.cpp b/src/proc/mobject/session/segment.cpp index 9ef7e8a0d..eaa169f02 100644 --- a/src/proc/mobject/session/segment.cpp +++ b/src/proc/mobject/session/segment.cpp @@ -20,6 +20,11 @@ * *****************************************************/ + +/** @file §§§ + ** TODO §§§ + */ + #include "proc/mobject/session/segment.hpp" #include "proc/mobject/explicitplacement.hpp" diff --git a/src/proc/mobject/session/segment.hpp b/src/proc/mobject/session/segment.hpp index 593c81d94..a4d8e3aab 100644 --- a/src/proc/mobject/session/segment.hpp +++ b/src/proc/mobject/session/segment.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_SESSION_SEGMENT_H #define MOBJECT_SESSION_SEGMENT_H diff --git a/src/proc/mobject/session/segmentation.cpp b/src/proc/mobject/session/segmentation.cpp index 16bb9c1e4..f1ede1ab4 100644 --- a/src/proc/mobject/session/segmentation.cpp +++ b/src/proc/mobject/session/segmentation.cpp @@ -20,6 +20,11 @@ * *****************************************************/ + +/** @file §§§ + ** TODO §§§ + */ + #include "proc/mobject/session/segmentation.hpp" diff --git a/src/proc/mobject/session/segmentation.hpp b/src/proc/mobject/session/segmentation.hpp index 08dac8c93..e7e0f4f61 100644 --- a/src/proc/mobject/session/segmentation.hpp +++ b/src/proc/mobject/session/segmentation.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_SESSION_SEGMENTATION_H #define MOBJECT_SESSION_SEGMENTATION_H diff --git a/src/proc/mobject/session/sess-manager-impl.hpp b/src/proc/mobject/session/sess-manager-impl.hpp index 120d8a663..9919f2a47 100644 --- a/src/proc/mobject/session/sess-manager-impl.hpp +++ b/src/proc/mobject/session/sess-manager-impl.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_SESSION_SESS_MANAGER_IMPL_H #define MOBJECT_SESSION_SESS_MANAGER_IMPL_H diff --git a/src/proc/mobject/session/session-impl.cpp b/src/proc/mobject/session/session-impl.cpp index decf06612..5979c5596 100644 --- a/src/proc/mobject/session/session-impl.cpp +++ b/src/proc/mobject/session/session-impl.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/session-impl.hpp" #include "proc/mobject/session/mobjectfactory.hpp" #include "proc/mobject/session/query-focus.hpp" diff --git a/src/proc/mobject/session/session-services.cpp b/src/proc/mobject/session/session-services.cpp index 5ab2470b1..dd7cfbfed 100644 --- a/src/proc/mobject/session/session-services.cpp +++ b/src/proc/mobject/session/session-services.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/session-service-fetch.hpp" #include "proc/mobject/session/session-service-mutate.hpp" #include "proc/mobject/session/session-service-explore-scope.hpp" diff --git a/src/proc/mobject/session/specific-contents-query.hpp b/src/proc/mobject/session/specific-contents-query.hpp index 531f8d067..a527d3978 100644 --- a/src/proc/mobject/session/specific-contents-query.hpp +++ b/src/proc/mobject/session/specific-contents-query.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_SESSION_SPECIFIC_CONTENTS_QUERY_H #define MOBJECT_SESSION_SPECIFIC_CONTENTS_QUERY_H diff --git a/src/proc/mobject/session/wish.cpp b/src/proc/mobject/session/wish.cpp index 9973feee2..6459d5b80 100644 --- a/src/proc/mobject/session/wish.cpp +++ b/src/proc/mobject/session/wish.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/mobject/session/wish.hpp" namespace proc { diff --git a/src/proc/mobject/session/wish.hpp b/src/proc/mobject/session/wish.hpp index 7040589f1..13c5799d9 100644 --- a/src/proc/mobject/session/wish.hpp +++ b/src/proc/mobject/session/wish.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef MOBJECT_SESSION_WISH_H #define MOBJECT_SESSION_WISH_H diff --git a/src/proc/play/dummy-play-connection.cpp b/src/proc/play/dummy-play-connection.cpp index 9691f9dd6..ac5ad610e 100644 --- a/src/proc/play/dummy-play-connection.cpp +++ b/src/proc/play/dummy-play-connection.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/play/dummy-play-connection.hpp" //#include "proc/play/dummy-image-generator.hpp" //#include "proc/play/tick-service.hpp" diff --git a/src/proc/play/dummy-player-service.cpp b/src/proc/play/dummy-player-service.cpp index aafb29433..76025ac9b 100644 --- a/src/proc/play/dummy-player-service.cpp +++ b/src/proc/play/dummy-player-service.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/play/dummy-player-service.hpp" #include "proc/engine/worker/dummy-image-generator.hpp" #include "proc/engine/worker/tick-service.hpp" diff --git a/src/proc/play/output-director.cpp b/src/proc/play/output-director.cpp index 416445700..a259d3cf3 100644 --- a/src/proc/play/output-director.cpp +++ b/src/proc/play/output-director.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/play/play-service.hpp" #include "proc/play/output-manager.hpp" #include "proc/play/output-director.hpp" diff --git a/src/proc/play/output-slot.cpp b/src/proc/play/output-slot.cpp index e063aaf81..8899248d2 100644 --- a/src/proc/play/output-slot.cpp +++ b/src/proc/play/output-slot.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/error.hpp" #include "proc/play/output-slot.hpp" #include "proc/play/output-slot-connection.hpp" diff --git a/src/proc/play/play-process.cpp b/src/proc/play/play-process.cpp index c412e8a8f..126e59327 100644 --- a/src/proc/play/play-process.cpp +++ b/src/proc/play/play-process.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/play/play-process.hpp" #include "proc/play/play-service.hpp" #include "proc/play/render-configurator.hpp" diff --git a/src/proc/play/play-service.cpp b/src/proc/play/play-service.cpp index b3824585d..7b8bef9d0 100644 --- a/src/proc/play/play-service.cpp +++ b/src/proc/play/play-service.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/error.hpp" #include "include/play-facade.h" #include "proc/play/play-service.hpp" diff --git a/src/proc/play/render-configurator.cpp b/src/proc/play/render-configurator.cpp index e0be1facd..8e080e038 100644 --- a/src/proc/play/render-configurator.cpp +++ b/src/proc/play/render-configurator.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "lib/error.hpp" #include "proc/play/render-configurator.hpp" #include "proc/play/output-manager.hpp" diff --git a/src/proc/play/sound/jack-output.cpp b/src/proc/play/sound/jack-output.cpp index 4fc576d0d..3de0d6d2b 100644 --- a/src/proc/play/sound/jack-output.cpp +++ b/src/proc/play/sound/jack-output.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/play/sound/jack-output.hpp" namespace proc { diff --git a/src/proc/play/timings.cpp b/src/proc/play/timings.cpp index de12984d6..c93923ba9 100644 --- a/src/proc/play/timings.cpp +++ b/src/proc/play/timings.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/play/timings.hpp" #include "backend/engine/engine-config.h" #include "lib/time/formats.hpp" diff --git a/src/proc/state.cpp b/src/proc/state.cpp index 15dc9ba3a..c70a24ecb 100644 --- a/src/proc/state.cpp +++ b/src/proc/state.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/state.hpp" namespace proc_interface { diff --git a/src/proc/state.hpp b/src/proc/state.hpp index e2e7414f4..7ad7478d6 100644 --- a/src/proc/state.hpp +++ b/src/proc/state.hpp @@ -21,6 +21,11 @@ */ +/** @file §§§ + ** TODO §§§ + */ + + #ifndef PROC_INTERFACE_STATE_H #define PROC_INTERFACE_STATE_H diff --git a/src/proc/streamtype.cpp b/src/proc/streamtype.cpp index 0213ba211..c8f0d71d0 100644 --- a/src/proc/streamtype.cpp +++ b/src/proc/streamtype.cpp @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file §§§ + ** TODO §§§ + */ + + #include "proc/streamtype.hpp" diff --git a/tests/backend/sync-classlock-test.cpp b/tests/backend/sync-classlock-test.cpp index 8eace7879..64b4f7736 100644 --- a/tests/backend/sync-classlock-test.cpp +++ b/tests/backend/sync-classlock-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/error.hpp" diff --git a/tests/backend/sync-locking-test.cpp b/tests/backend/sync-locking-test.cpp index eab82cf44..8cc525f19 100644 --- a/tests/backend/sync-locking-test.cpp +++ b/tests/backend/sync-locking-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/error.hpp" diff --git a/tests/backend/sync-timedwait-test.cpp b/tests/backend/sync-timedwait-test.cpp index 998606d02..46907d6b0 100644 --- a/tests/backend/sync-timedwait-test.cpp +++ b/tests/backend/sync-timedwait-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/error.hpp" diff --git a/tests/backend/sync-waiting-test.cpp b/tests/backend/sync-waiting-test.cpp index 2e2004b76..a96e565e5 100644 --- a/tests/backend/sync-waiting-test.cpp +++ b/tests/backend/sync-waiting-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/error.hpp" diff --git a/tests/backend/thread-local-test.cpp b/tests/backend/thread-local-test.cpp index 4cbd895c3..2268728c2 100644 --- a/tests/backend/thread-local-test.cpp +++ b/tests/backend/thread-local-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/backend/thread-wrapper-join-test.cpp b/tests/backend/thread-wrapper-join-test.cpp index 36ba34851..9650fd924 100644 --- a/tests/backend/thread-wrapper-join-test.cpp +++ b/tests/backend/thread-wrapper-join-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/backend/thread-wrapper-test.cpp b/tests/backend/thread-wrapper-test.cpp index 6f643a5fd..6f7854ebe 100644 --- a/tests/backend/thread-wrapper-test.cpp +++ b/tests/backend/thread-wrapper-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/basics/diagnostic-context-test.cpp b/tests/basics/diagnostic-context-test.cpp index 2f1168bee..b39136724 100644 --- a/tests/basics/diagnostic-context-test.cpp +++ b/tests/basics/diagnostic-context-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/basics/streamtypebasicstest.cpp b/tests/basics/streamtypebasicstest.cpp index a211248ac..cf628514e 100644 --- a/tests/basics/streamtypebasicstest.cpp +++ b/tests/basics/streamtypebasicstest.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/util.hpp" diff --git a/tests/basics/streamtypelifecycletest.cpp b/tests/basics/streamtypelifecycletest.cpp index ea69e7324..a578bef53 100644 --- a/tests/basics/streamtypelifecycletest.cpp +++ b/tests/basics/streamtypelifecycletest.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/util.hpp" diff --git a/tests/basics/teststreamtypes.hpp b/tests/basics/teststreamtypes.hpp index db22fe9cb..5aac23dc2 100644 --- a/tests/basics/teststreamtypes.hpp +++ b/tests/basics/teststreamtypes.hpp @@ -20,6 +20,10 @@ */ +/** @file §§§ + ** unit test TODO §§§ + */ + #ifndef LUMIERA_TEST_TESTSTREAMTYPES_H #define LUMIERA_TEST_TESTSTREAMTYPES_H diff --git a/tests/basics/time/digxel-configurations-test.cpp b/tests/basics/time/digxel-configurations-test.cpp index ee09b60a6..0101536a4 100644 --- a/tests/basics/time/digxel-configurations-test.cpp +++ b/tests/basics/time/digxel-configurations-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/basics/time/digxel-test.cpp b/tests/basics/time/digxel-test.cpp index 2a3a78936..2ff4d98af 100644 --- a/tests/basics/time/digxel-test.cpp +++ b/tests/basics/time/digxel-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/format-cout.hpp" diff --git a/tests/basics/time/format-support-test.cpp b/tests/basics/time/format-support-test.cpp index b1f90465d..46c945006 100644 --- a/tests/basics/time/format-support-test.cpp +++ b/tests/basics/time/format-support-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/time/formats.hpp" diff --git a/tests/basics/time/quantiser-basics-test.cpp b/tests/basics/time/quantiser-basics-test.cpp index edc4ced6a..98548eeaf 100644 --- a/tests/basics/time/quantiser-basics-test.cpp +++ b/tests/basics/time/quantiser-basics-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/basics/time/time-basics-test.cpp b/tests/basics/time/time-basics-test.cpp index 4e1cd3b99..d49eebd1a 100644 --- a/tests/basics/time/time-basics-test.cpp +++ b/tests/basics/time/time-basics-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/time/timevalue.hpp" diff --git a/tests/basics/time/time-control-test.cpp b/tests/basics/time/time-control-test.cpp index b2e878eae..0db230cc8 100644 --- a/tests/basics/time/time-control-test.cpp +++ b/tests/basics/time/time-control-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/basics/time/time-formats-test.cpp b/tests/basics/time/time-formats-test.cpp index 040259a1a..45d0780e6 100644 --- a/tests/basics/time/time-formats-test.cpp +++ b/tests/basics/time/time-formats-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" //#include "lib/test/test-helper.hpp" diff --git a/tests/basics/time/time-mutation-test.cpp b/tests/basics/time/time-mutation-test.cpp index eef879f35..e8f02fce0 100644 --- a/tests/basics/time/time-mutation-test.cpp +++ b/tests/basics/time/time-mutation-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/basics/time/time-parsing-test.cpp b/tests/basics/time/time-parsing-test.cpp index ddb2acd4f..10509fac8 100644 --- a/tests/basics/time/time-parsing-test.cpp +++ b/tests/basics/time/time-parsing-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/basics/time/time-quantisation-test.cpp b/tests/basics/time/time-quantisation-test.cpp index 24eff8eb6..c8fad87f2 100644 --- a/tests/basics/time/time-quantisation-test.cpp +++ b/tests/basics/time/time-quantisation-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/basics/time/time-value-test.cpp b/tests/basics/time/time-value-test.cpp index d26a7cc8e..aa6a2a12b 100644 --- a/tests/basics/time/time-value-test.cpp +++ b/tests/basics/time/time-value-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/basics/visitingtool-extended-test.cpp b/tests/basics/visitingtool-extended-test.cpp index 85e79b882..7cb6c621e 100644 --- a/tests/basics/visitingtool-extended-test.cpp +++ b/tests/basics/visitingtool-extended-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/visitor.hpp" diff --git a/tests/basics/visitingtool-test.cpp b/tests/basics/visitingtool-test.cpp index a868aa3a8..bfeb575f4 100644 --- a/tests/basics/visitingtool-test.cpp +++ b/tests/basics/visitingtool-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/visitor.hpp" diff --git a/tests/core/application/subsystem-runner-test.cpp b/tests/core/application/subsystem-runner-test.cpp index e838d7e9c..bf19da6d1 100644 --- a/tests/core/application/subsystem-runner-test.cpp +++ b/tests/core/application/subsystem-runner-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/backend/engine/dummy-job.cpp b/tests/core/backend/engine/dummy-job.cpp index 029cdaf7f..7cbd639fd 100644 --- a/tests/core/backend/engine/dummy-job.cpp +++ b/tests/core/backend/engine/dummy-job.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "backend/engine/dummy-job.hpp" diff --git a/tests/core/backend/engine/dummy-job.hpp b/tests/core/backend/engine/dummy-job.hpp index 102085926..217f0ce80 100644 --- a/tests/core/backend/engine/dummy-job.hpp +++ b/tests/core/backend/engine/dummy-job.hpp @@ -20,6 +20,10 @@ */ +/** @file §§§ + ** unit test TODO §§§ + */ + #ifndef BACKEND_ENGINE_DUMMY_JOB_H #define BACKEND_ENGINE_DUMMY_JOB_H diff --git a/tests/core/backend/engine/job-hash-test.cpp b/tests/core/backend/engine/job-hash-test.cpp index e73002cc3..f59c9c349 100644 --- a/tests/core/backend/engine/job-hash-test.cpp +++ b/tests/core/backend/engine/job-hash-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/util.hpp" diff --git a/tests/core/backend/engine/scheduler-interface-test.cpp b/tests/core/backend/engine/scheduler-interface-test.cpp index 46704ad20..a5ef297c9 100644 --- a/tests/core/backend/engine/scheduler-interface-test.cpp +++ b/tests/core/backend/engine/scheduler-interface-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/util.hpp" diff --git a/tests/core/backend/media-access-mock-test.cpp b/tests/core/backend/media-access-mock-test.cpp index 6b316b9e6..ec018b900 100644 --- a/tests/core/backend/media-access-mock-test.cpp +++ b/tests/core/backend/media-access-mock-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "backend/media-access-facade.hpp" #include "backend/media-access-mock.hpp" diff --git a/tests/core/backend/media-access-mock.hpp b/tests/core/backend/media-access-mock.hpp index c44e61b3c..17c3ed267 100644 --- a/tests/core/backend/media-access-mock.hpp +++ b/tests/core/backend/media-access-mock.hpp @@ -20,6 +20,10 @@ */ +/** @file §§§ + ** unit test TODO §§§ + */ + #ifndef BACKEND_TEST_MEDIA_ACCESS_MOCK_H #define BACKEND_TEST_MEDIA_ACCESS_MOCK_H diff --git a/tests/core/proc/asset/asset-category-test.cpp b/tests/core/proc/asset/asset-category-test.cpp index 86f4e9a64..91bb00e24 100644 --- a/tests/core/proc/asset/asset-category-test.cpp +++ b/tests/core/proc/asset/asset-category-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/format-cout.hpp" diff --git a/tests/core/proc/asset/basicpipetest.cpp b/tests/core/proc/asset/basicpipetest.cpp index b20910eed..56e94b451 100644 --- a/tests/core/proc/asset/basicpipetest.cpp +++ b/tests/core/proc/asset/basicpipetest.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "include/logging.h" #include "lib/test/run.hpp" diff --git a/tests/core/proc/asset/compoundmediatest.cpp b/tests/core/proc/asset/compoundmediatest.cpp index b63ce29f6..166cb6c89 100644 --- a/tests/core/proc/asset/compoundmediatest.cpp +++ b/tests/core/proc/asset/compoundmediatest.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "include/logging.h" #include "lib/test/run.hpp" diff --git a/tests/core/proc/asset/create-asset-test.cpp b/tests/core/proc/asset/create-asset-test.cpp index 7d54201b6..eaecfee72 100644 --- a/tests/core/proc/asset/create-asset-test.cpp +++ b/tests/core/proc/asset/create-asset-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "include/logging.h" #include "lib/test/run.hpp" diff --git a/tests/core/proc/asset/deleteassettest.cpp b/tests/core/proc/asset/deleteassettest.cpp index a03d30356..1f539bd70 100644 --- a/tests/core/proc/asset/deleteassettest.cpp +++ b/tests/core/proc/asset/deleteassettest.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" //#include "lib/util.hpp" diff --git a/tests/core/proc/asset/dependent-assets-test.cpp b/tests/core/proc/asset/dependent-assets-test.cpp index 7ba5a0a33..6f40dfde4 100644 --- a/tests/core/proc/asset/dependent-assets-test.cpp +++ b/tests/core/proc/asset/dependent-assets-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/asset/testasset.hpp" diff --git a/tests/core/proc/asset/entry-id-test.cpp b/tests/core/proc/asset/entry-id-test.cpp index 4f58cbb23..1d239b2d8 100644 --- a/tests/core/proc/asset/entry-id-test.cpp +++ b/tests/core/proc/asset/entry-id-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/asset/identityofassetstest.cpp b/tests/core/proc/asset/identityofassetstest.cpp index 226b472c5..e0daef0c5 100644 --- a/tests/core/proc/asset/identityofassetstest.cpp +++ b/tests/core/proc/asset/identityofassetstest.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "include/logging.h" #include "lib/test/run.hpp" diff --git a/tests/core/proc/asset/makecliptest.cpp b/tests/core/proc/asset/makecliptest.cpp index 1b556d36f..74faa644e 100644 --- a/tests/core/proc/asset/makecliptest.cpp +++ b/tests/core/proc/asset/makecliptest.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "include/logging.h" #include "lib/test/run.hpp" diff --git a/tests/core/proc/asset/mediastructurequerytest.cpp b/tests/core/proc/asset/mediastructurequerytest.cpp index 4f6397e84..e07142718 100644 --- a/tests/core/proc/asset/mediastructurequerytest.cpp +++ b/tests/core/proc/asset/mediastructurequerytest.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/util.hpp" diff --git a/tests/core/proc/asset/meta/time-grid-basics-test.cpp b/tests/core/proc/asset/meta/time-grid-basics-test.cpp index 5d4d47beb..019c07433 100644 --- a/tests/core/proc/asset/meta/time-grid-basics-test.cpp +++ b/tests/core/proc/asset/meta/time-grid-basics-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/asset/orderingofassetstest.cpp b/tests/core/proc/asset/orderingofassetstest.cpp index 849bc9890..411d160bf 100644 --- a/tests/core/proc/asset/orderingofassetstest.cpp +++ b/tests/core/proc/asset/orderingofassetstest.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/util.hpp" diff --git a/tests/core/proc/asset/testasset.cpp b/tests/core/proc/asset/testasset.cpp index 3bc9b0437..3342d5e74 100644 --- a/tests/core/proc/asset/testasset.cpp +++ b/tests/core/proc/asset/testasset.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "proc/asset/testasset.hpp" #include "proc/assetmanager.hpp" diff --git a/tests/core/proc/asset/testasset.hpp b/tests/core/proc/asset/testasset.hpp index 0b4c73f5d..689b1262e 100644 --- a/tests/core/proc/asset/testasset.hpp +++ b/tests/core/proc/asset/testasset.hpp @@ -20,6 +20,10 @@ */ +/** @file §§§ + ** unit test TODO §§§ + */ + #ifndef ASSET_TESTASSET_H #define ASSET_TESTASSET_H diff --git a/tests/core/proc/asset/testclipasset.hpp b/tests/core/proc/asset/testclipasset.hpp index 4d0ca97c9..e31616f8d 100644 --- a/tests/core/proc/asset/testclipasset.hpp +++ b/tests/core/proc/asset/testclipasset.hpp @@ -20,6 +20,10 @@ */ +/** @file §§§ + ** unit test TODO §§§ + */ + #ifndef ASSET_TESTCLIPASSET_H #define ASSET_TESTCLIPASSET_H diff --git a/tests/core/proc/asset/typed-id-test.cpp b/tests/core/proc/asset/typed-id-test.cpp index ae2c80977..7d3e2c0d9 100644 --- a/tests/core/proc/asset/typed-id-test.cpp +++ b/tests/core/proc/asset/typed-id-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/control/argument-tuple-accept-test.cpp b/tests/core/proc/control/argument-tuple-accept-test.cpp index 132befc5d..b1c402b4c 100644 --- a/tests/core/proc/control/argument-tuple-accept-test.cpp +++ b/tests/core/proc/control/argument-tuple-accept-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/control/command-argument-test.cpp b/tests/core/proc/control/command-argument-test.cpp index 91031f296..47b7d7971 100644 --- a/tests/core/proc/control/command-argument-test.cpp +++ b/tests/core/proc/control/command-argument-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/control/command-basic-test.cpp b/tests/core/proc/control/command-basic-test.cpp index 5dae1f42a..3edb79b7b 100644 --- a/tests/core/proc/control/command-basic-test.cpp +++ b/tests/core/proc/control/command-basic-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/control/command-def.hpp" diff --git a/tests/core/proc/control/command-binding-test.cpp b/tests/core/proc/control/command-binding-test.cpp index 549137d2a..5a4e75387 100644 --- a/tests/core/proc/control/command-binding-test.cpp +++ b/tests/core/proc/control/command-binding-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/control/command-def.hpp" diff --git a/tests/core/proc/control/command-clone-builder-test.cpp b/tests/core/proc/control/command-clone-builder-test.cpp index 266a877f7..6d0c3e636 100644 --- a/tests/core/proc/control/command-clone-builder-test.cpp +++ b/tests/core/proc/control/command-clone-builder-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/control/command-impl.hpp" diff --git a/tests/core/proc/control/command-equality-test.cpp b/tests/core/proc/control/command-equality-test.cpp index 9cfe98fbe..cc8ed71f1 100644 --- a/tests/core/proc/control/command-equality-test.cpp +++ b/tests/core/proc/control/command-equality-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/control/command-message-binding-test.cpp b/tests/core/proc/control/command-message-binding-test.cpp index e763d5c90..32c011e5c 100644 --- a/tests/core/proc/control/command-message-binding-test.cpp +++ b/tests/core/proc/control/command-message-binding-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/control/command-mutation-test.cpp b/tests/core/proc/control/command-mutation-test.cpp index 3d1ae2672..c839c37fb 100644 --- a/tests/core/proc/control/command-mutation-test.cpp +++ b/tests/core/proc/control/command-mutation-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/control/command-registry-test.cpp b/tests/core/proc/control/command-registry-test.cpp index a36da3d00..59a4c2c13 100644 --- a/tests/core/proc/control/command-registry-test.cpp +++ b/tests/core/proc/control/command-registry-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/control/command-use1-test.cpp b/tests/core/proc/control/command-use1-test.cpp index 4e87538d1..05be504a4 100644 --- a/tests/core/proc/control/command-use1-test.cpp +++ b/tests/core/proc/control/command-use1-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/control/command-use2-test.cpp b/tests/core/proc/control/command-use2-test.cpp index 3e5bb5bf5..a2f107190 100644 --- a/tests/core/proc/control/command-use2-test.cpp +++ b/tests/core/proc/control/command-use2-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/control/command-use3-test.cpp b/tests/core/proc/control/command-use3-test.cpp index 32c6ffe9b..5c1a644d9 100644 --- a/tests/core/proc/control/command-use3-test.cpp +++ b/tests/core/proc/control/command-use3-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/control/handling-pattern-basics-test.cpp b/tests/core/proc/control/handling-pattern-basics-test.cpp index 844599503..732a68870 100644 --- a/tests/core/proc/control/handling-pattern-basics-test.cpp +++ b/tests/core/proc/control/handling-pattern-basics-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/control/command.hpp" diff --git a/tests/core/proc/control/handling-pattern-standard-impl-test.cpp b/tests/core/proc/control/handling-pattern-standard-impl-test.cpp index 3e9c04320..8bae309a1 100644 --- a/tests/core/proc/control/handling-pattern-standard-impl-test.cpp +++ b/tests/core/proc/control/handling-pattern-standard-impl-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" //#include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/control/memento-tie-test.cpp b/tests/core/proc/control/memento-tie-test.cpp index aea4af164..44626a3a4 100644 --- a/tests/core/proc/control/memento-tie-test.cpp +++ b/tests/core/proc/control/memento-tie-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/control/test-dummy-commands.cpp b/tests/core/proc/control/test-dummy-commands.cpp index 64e4aaa67..af7d34948 100644 --- a/tests/core/proc/control/test-dummy-commands.cpp +++ b/tests/core/proc/control/test-dummy-commands.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "proc/control/test-dummy-commands.hpp" diff --git a/tests/core/proc/engine/buff-table-test.cpp b/tests/core/proc/engine/buff-table-test.cpp index 859a027fe..9faad747a 100644 --- a/tests/core/proc/engine/buff-table-test.cpp +++ b/tests/core/proc/engine/buff-table-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/error.hpp" diff --git a/tests/core/proc/engine/buffer-metadata-key-test.cpp b/tests/core/proc/engine/buffer-metadata-key-test.cpp index 93449ae07..c9237d980 100644 --- a/tests/core/proc/engine/buffer-metadata-key-test.cpp +++ b/tests/core/proc/engine/buffer-metadata-key-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/error.hpp" #include "lib/test/run.hpp" diff --git a/tests/core/proc/engine/buffer-metadata-test.cpp b/tests/core/proc/engine/buffer-metadata-test.cpp index dfa58fe65..3ceb0b0f0 100644 --- a/tests/core/proc/engine/buffer-metadata-test.cpp +++ b/tests/core/proc/engine/buffer-metadata-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/error.hpp" #include "lib/test/run.hpp" diff --git a/tests/core/proc/engine/buffer-provider-protocol-test.cpp b/tests/core/proc/engine/buffer-provider-protocol-test.cpp index af53d51e3..7c60d9d03 100644 --- a/tests/core/proc/engine/buffer-provider-protocol-test.cpp +++ b/tests/core/proc/engine/buffer-provider-protocol-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/error.hpp" #include "lib/test/run.hpp" diff --git a/tests/core/proc/engine/calc-stream-test.cpp b/tests/core/proc/engine/calc-stream-test.cpp index 6993b02e8..a557070f8 100644 --- a/tests/core/proc/engine/calc-stream-test.cpp +++ b/tests/core/proc/engine/calc-stream-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/error.hpp" diff --git a/tests/core/proc/engine/dispatcher-interface-test.cpp b/tests/core/proc/engine/dispatcher-interface-test.cpp index e75603f7d..2498d7250 100644 --- a/tests/core/proc/engine/dispatcher-interface-test.cpp +++ b/tests/core/proc/engine/dispatcher-interface-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/error.hpp" diff --git a/tests/core/proc/engine/engine-interface-test.cpp b/tests/core/proc/engine/engine-interface-test.cpp index 025475bb6..d99ad0b1a 100644 --- a/tests/core/proc/engine/engine-interface-test.cpp +++ b/tests/core/proc/engine/engine-interface-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/error.hpp" diff --git a/tests/core/proc/engine/node-basic-test.cpp b/tests/core/proc/engine/node-basic-test.cpp index 56a61a16a..d3e6f7bfb 100644 --- a/tests/core/proc/engine/node-basic-test.cpp +++ b/tests/core/proc/engine/node-basic-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/engine/nodefactory.hpp" diff --git a/tests/core/proc/engine/node-fabrication-test.cpp b/tests/core/proc/engine/node-fabrication-test.cpp index a4fef5324..302bec5ba 100644 --- a/tests/core/proc/engine/node-fabrication-test.cpp +++ b/tests/core/proc/engine/node-fabrication-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" //#include "lib/util.hpp" diff --git a/tests/core/proc/engine/node-operation-test.cpp b/tests/core/proc/engine/node-operation-test.cpp index 0e3a7e3f4..e0e5bbd5c 100644 --- a/tests/core/proc/engine/node-operation-test.cpp +++ b/tests/core/proc/engine/node-operation-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" //#include "lib/util.hpp" diff --git a/tests/core/proc/engine/node-source-test.cpp b/tests/core/proc/engine/node-source-test.cpp index a722e052d..1fadd8244 100644 --- a/tests/core/proc/engine/node-source-test.cpp +++ b/tests/core/proc/engine/node-source-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" //#include "lib/util.hpp" diff --git a/tests/core/proc/engine/testframe-test.cpp b/tests/core/proc/engine/testframe-test.cpp index ffd083ed8..79419fe07 100644 --- a/tests/core/proc/engine/testframe-test.cpp +++ b/tests/core/proc/engine/testframe-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/engine/testframe.hpp" diff --git a/tests/core/proc/engine/testframe.cpp b/tests/core/proc/engine/testframe.cpp index 9b404dbf5..3b58924a6 100644 --- a/tests/core/proc/engine/testframe.cpp +++ b/tests/core/proc/engine/testframe.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "proc/engine/testframe.hpp" #include "lib/error.hpp" diff --git a/tests/core/proc/engine/testframe.hpp b/tests/core/proc/engine/testframe.hpp index 05cfecff8..a124f4e1b 100644 --- a/tests/core/proc/engine/testframe.hpp +++ b/tests/core/proc/engine/testframe.hpp @@ -20,6 +20,10 @@ */ +/** @file §§§ + ** unit test TODO §§§ + */ + #ifndef PROC_ENGINE_TESTFRAME_H #define PROC_ENGINE_TESTFRAME_H diff --git a/tests/core/proc/engine/tracking-heap-block-provider-test.cpp b/tests/core/proc/engine/tracking-heap-block-provider-test.cpp index 79aa9ffd2..70c515b92 100644 --- a/tests/core/proc/engine/tracking-heap-block-provider-test.cpp +++ b/tests/core/proc/engine/tracking-heap-block-provider-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/error.hpp" #include "lib/test/run.hpp" diff --git a/tests/core/proc/mobject/builder/buildertooltest.cpp b/tests/core/proc/mobject/builder/buildertooltest.cpp index 8ac47cf24..5bd7a8f96 100644 --- a/tests/core/proc/mobject/builder/buildertooltest.cpp +++ b/tests/core/proc/mobject/builder/buildertooltest.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/core/proc/mobject/builder/buildsegmenttest.cpp b/tests/core/proc/mobject/builder/buildsegmenttest.cpp index 95bd3b2c0..3d94a2e00 100644 --- a/tests/core/proc/mobject/builder/buildsegmenttest.cpp +++ b/tests/core/proc/mobject/builder/buildsegmenttest.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" //#include "lib/util.hpp" diff --git a/tests/core/proc/mobject/builder/fixture-change-detector-test.cpp b/tests/core/proc/mobject/builder/fixture-change-detector-test.cpp index 1f0397242..dc3759678 100644 --- a/tests/core/proc/mobject/builder/fixture-change-detector-test.cpp +++ b/tests/core/proc/mobject/builder/fixture-change-detector-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/mobject/builder/model-port-registry-test.cpp b/tests/core/proc/mobject/builder/model-port-registry-test.cpp index 1d47fb689..d31915a9e 100644 --- a/tests/core/proc/mobject/builder/model-port-registry-test.cpp +++ b/tests/core/proc/mobject/builder/model-port-registry-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/mobject/builder/segmentation-datastructure-test.cpp b/tests/core/proc/mobject/builder/segmentation-datastructure-test.cpp index 6bf35fbd8..b08d5c24f 100644 --- a/tests/core/proc/mobject/builder/segmentation-datastructure-test.cpp +++ b/tests/core/proc/mobject/builder/segmentation-datastructure-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/mobject/controller/rendersegmenttest.cpp b/tests/core/proc/mobject/controller/rendersegmenttest.cpp index 7b148c3e9..91795db0c 100644 --- a/tests/core/proc/mobject/controller/rendersegmenttest.cpp +++ b/tests/core/proc/mobject/controller/rendersegmenttest.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" //#include "lib/util.hpp" diff --git a/tests/core/proc/mobject/mobject-interface-test.cpp b/tests/core/proc/mobject/mobject-interface-test.cpp index 4a78cf813..54791cc13 100644 --- a/tests/core/proc/mobject/mobject-interface-test.cpp +++ b/tests/core/proc/mobject/mobject-interface-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/symbol.hpp" diff --git a/tests/core/proc/mobject/mobject-ref-test.cpp b/tests/core/proc/mobject/mobject-ref-test.cpp index 2b7469e9b..5b3196efb 100644 --- a/tests/core/proc/mobject/mobject-ref-test.cpp +++ b/tests/core/proc/mobject/mobject-ref-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/asset/media.hpp" diff --git a/tests/core/proc/mobject/output-mapping-test.cpp b/tests/core/proc/mobject/output-mapping-test.cpp index 6dec6103a..ea4124859 100644 --- a/tests/core/proc/mobject/output-mapping-test.cpp +++ b/tests/core/proc/mobject/output-mapping-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/mobject/placement-basic-test.cpp b/tests/core/proc/mobject/placement-basic-test.cpp index b4edf1c0a..a83bb1368 100644 --- a/tests/core/proc/mobject/placement-basic-test.cpp +++ b/tests/core/proc/mobject/placement-basic-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/asset/media.hpp" diff --git a/tests/core/proc/mobject/placement-hierarchy-test.cpp b/tests/core/proc/mobject/placement-hierarchy-test.cpp index a2f667267..3ae1c80ed 100644 --- a/tests/core/proc/mobject/placement-hierarchy-test.cpp +++ b/tests/core/proc/mobject/placement-hierarchy-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/mobject/placement-object-identity-test.cpp b/tests/core/proc/mobject/placement-object-identity-test.cpp index 1de776ff6..080fa2b89 100644 --- a/tests/core/proc/mobject/placement-object-identity-test.cpp +++ b/tests/core/proc/mobject/placement-object-identity-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/asset/media.hpp" diff --git a/tests/core/proc/mobject/placement-ref-test.cpp b/tests/core/proc/mobject/placement-ref-test.cpp index b3c984ff7..5062af9ad 100644 --- a/tests/core/proc/mobject/placement-ref-test.cpp +++ b/tests/core/proc/mobject/placement-ref-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/mobject/session/addcliptest.cpp b/tests/core/proc/mobject/session/addcliptest.cpp index 0f05faac2..2ed241473 100644 --- a/tests/core/proc/mobject/session/addcliptest.cpp +++ b/tests/core/proc/mobject/session/addcliptest.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/mobject/session.hpp" diff --git a/tests/core/proc/mobject/session/defs-manager-impl-test.cpp b/tests/core/proc/mobject/session/defs-manager-impl-test.cpp index 83f88776f..fbf32ac25 100644 --- a/tests/core/proc/mobject/session/defs-manager-impl-test.cpp +++ b/tests/core/proc/mobject/session/defs-manager-impl-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/util.hpp" diff --git a/tests/core/proc/mobject/session/defs-manager-test.cpp b/tests/core/proc/mobject/session/defs-manager-test.cpp index 60d29dc31..61427b3aa 100644 --- a/tests/core/proc/mobject/session/defs-manager-test.cpp +++ b/tests/core/proc/mobject/session/defs-manager-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/symbol.hpp" diff --git a/tests/core/proc/mobject/session/defs-registry-impl-test.cpp b/tests/core/proc/mobject/session/defs-registry-impl-test.cpp index dddebd38e..212fd1bf1 100644 --- a/tests/core/proc/mobject/session/defs-registry-impl-test.cpp +++ b/tests/core/proc/mobject/session/defs-registry-impl-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/util.hpp" diff --git a/tests/core/proc/mobject/session/deletecliptest.cpp b/tests/core/proc/mobject/session/deletecliptest.cpp index 63600cdac..8b0c046f9 100644 --- a/tests/core/proc/mobject/session/deletecliptest.cpp +++ b/tests/core/proc/mobject/session/deletecliptest.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/assetmanager.hpp" diff --git a/tests/core/proc/mobject/session/placement-index-query-test.cpp b/tests/core/proc/mobject/session/placement-index-query-test.cpp index c0d451224..8932652bc 100644 --- a/tests/core/proc/mobject/session/placement-index-query-test.cpp +++ b/tests/core/proc/mobject/session/placement-index-query-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/mobject/session/scope-query.hpp" diff --git a/tests/core/proc/mobject/session/placement-index-test.cpp b/tests/core/proc/mobject/session/placement-index-test.cpp index 62c8baebe..8b4b11fe3 100644 --- a/tests/core/proc/mobject/session/placement-index-test.cpp +++ b/tests/core/proc/mobject/session/placement-index-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/mobject/session/placement-scope-test.cpp b/tests/core/proc/mobject/session/placement-scope-test.cpp index 2d8e7e8ee..d27331dbd 100644 --- a/tests/core/proc/mobject/session/placement-scope-test.cpp +++ b/tests/core/proc/mobject/session/placement-scope-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/mobject/session/query-focus-stack-test.cpp b/tests/core/proc/mobject/session/query-focus-stack-test.cpp index 5a58fe445..ffa34b5ee 100644 --- a/tests/core/proc/mobject/session/query-focus-stack-test.cpp +++ b/tests/core/proc/mobject/session/query-focus-stack-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/mobject/session/query-focus-test.cpp b/tests/core/proc/mobject/session/query-focus-test.cpp index 129ed0388..2d5359bc9 100644 --- a/tests/core/proc/mobject/session/query-focus-test.cpp +++ b/tests/core/proc/mobject/session/query-focus-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/mobject/session/test-scopes.hpp" diff --git a/tests/core/proc/mobject/session/query-resolver-test.cpp b/tests/core/proc/mobject/session/query-resolver-test.cpp index b23ddb513..15d478c6b 100644 --- a/tests/core/proc/mobject/session/query-resolver-test.cpp +++ b/tests/core/proc/mobject/session/query-resolver-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/mobject/session/rebuildfixturetest.cpp b/tests/core/proc/mobject/session/rebuildfixturetest.cpp index 72053aa82..2abd43d02 100644 --- a/tests/core/proc/mobject/session/rebuildfixturetest.cpp +++ b/tests/core/proc/mobject/session/rebuildfixturetest.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/mobject/session.hpp" diff --git a/tests/core/proc/mobject/session/scope-path-test.cpp b/tests/core/proc/mobject/session/scope-path-test.cpp index 87957790a..1bf19fd84 100644 --- a/tests/core/proc/mobject/session/scope-path-test.cpp +++ b/tests/core/proc/mobject/session/scope-path-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/core/proc/mobject/session/scope-query-test.cpp b/tests/core/proc/mobject/session/scope-query-test.cpp index 4c55546fc..a56a7f76a 100644 --- a/tests/core/proc/mobject/session/scope-query-test.cpp +++ b/tests/core/proc/mobject/session/scope-query-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/mobject/session/scope-query.hpp" diff --git a/tests/core/proc/mobject/session/session-element-query-test.cpp b/tests/core/proc/mobject/session/session-element-query-test.cpp index df647c77d..fd59eb81f 100644 --- a/tests/core/proc/mobject/session/session-element-query-test.cpp +++ b/tests/core/proc/mobject/session/session-element-query-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/mobject/session/test-scopes.hpp" diff --git a/tests/core/proc/mobject/session/session-element-tracker-test.cpp b/tests/core/proc/mobject/session/session-element-tracker-test.cpp index bd236cf3d..888760f5d 100644 --- a/tests/core/proc/mobject/session/session-element-tracker-test.cpp +++ b/tests/core/proc/mobject/session/session-element-tracker-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/core/proc/mobject/session/session-modify-parts-test.cpp b/tests/core/proc/mobject/session/session-modify-parts-test.cpp index 14c9cad8b..dfa87ba7a 100644 --- a/tests/core/proc/mobject/session/session-modify-parts-test.cpp +++ b/tests/core/proc/mobject/session/session-modify-parts-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/mobject/session.hpp" diff --git a/tests/core/proc/mobject/session/session-service-access-test.cpp b/tests/core/proc/mobject/session/session-service-access-test.cpp index 941b83e8c..f5d16d99d 100644 --- a/tests/core/proc/mobject/session/session-service-access-test.cpp +++ b/tests/core/proc/mobject/session/session-service-access-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/mobject/session.hpp" diff --git a/tests/core/proc/mobject/session/session-structure-test.cpp b/tests/core/proc/mobject/session/session-structure-test.cpp index 37d741bbb..f7fd4f978 100644 --- a/tests/core/proc/mobject/session/session-structure-test.cpp +++ b/tests/core/proc/mobject/session/session-structure-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/mobject/session.hpp" diff --git a/tests/core/proc/mobject/session/sessionmanagertest.cpp b/tests/core/proc/mobject/session/sessionmanagertest.cpp index 8468e84b1..f0736a501 100644 --- a/tests/core/proc/mobject/session/sessionmanagertest.cpp +++ b/tests/core/proc/mobject/session/sessionmanagertest.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/mobject/session.hpp" diff --git a/tests/core/proc/mobject/session/test-scope-invalid.hpp b/tests/core/proc/mobject/session/test-scope-invalid.hpp index cadc0267a..24c302658 100644 --- a/tests/core/proc/mobject/session/test-scope-invalid.hpp +++ b/tests/core/proc/mobject/session/test-scope-invalid.hpp @@ -20,6 +20,10 @@ */ +/** @file §§§ + ** unit test TODO §§§ + */ + #ifndef MOBJECT_SESSION_TEST_SCOPE_INVALID_H #define MOBJECT_SESSION_TEST_SCOPE_INVALID_H diff --git a/tests/core/proc/mobject/session/test-scopes.cpp b/tests/core/proc/mobject/session/test-scopes.cpp index 4b08e1339..5e86d4397 100644 --- a/tests/core/proc/mobject/session/test-scopes.cpp +++ b/tests/core/proc/mobject/session/test-scopes.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "proc/mobject/session/test-scopes.hpp" #include "proc/mobject/session/session-service-mock-index.hpp" diff --git a/tests/core/proc/mobject/session/test-scopes.hpp b/tests/core/proc/mobject/session/test-scopes.hpp index f1e1a60fc..1702a30e1 100644 --- a/tests/core/proc/mobject/session/test-scopes.hpp +++ b/tests/core/proc/mobject/session/test-scopes.hpp @@ -20,6 +20,10 @@ */ +/** @file §§§ + ** unit test TODO §§§ + */ + #ifndef MOBJECT_SESSION_TEST_TEST_SCOPES_H #define MOBJECT_SESSION_TEST_TEST_SCOPES_H diff --git a/tests/core/proc/mobject/session/testclip.cpp b/tests/core/proc/mobject/session/testclip.cpp index 79c276aa5..b275f7753 100644 --- a/tests/core/proc/mobject/session/testclip.cpp +++ b/tests/core/proc/mobject/session/testclip.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "proc/mobject/session/testclip.hpp" #include "backend/media-access-facade.hpp" diff --git a/tests/core/proc/mobject/session/testclip.hpp b/tests/core/proc/mobject/session/testclip.hpp index 0f3179620..5a6d327f9 100644 --- a/tests/core/proc/mobject/session/testclip.hpp +++ b/tests/core/proc/mobject/session/testclip.hpp @@ -20,6 +20,10 @@ */ +/** @file §§§ + ** unit test TODO §§§ + */ + #ifndef MOBJECT_SESSION_TESTCLIP_H #define MOBJECT_SESSION_TESTCLIP_H diff --git a/tests/core/proc/mobject/session/testroot.hpp b/tests/core/proc/mobject/session/testroot.hpp index bbbd2d8e8..8c1474675 100644 --- a/tests/core/proc/mobject/session/testroot.hpp +++ b/tests/core/proc/mobject/session/testroot.hpp @@ -20,6 +20,10 @@ */ +/** @file §§§ + ** unit test TODO §§§ + */ + #ifndef MOBJECT_SESSION_TESTROOT_H #define MOBJECT_SESSION_TESTROOT_H diff --git a/tests/core/proc/mobject/session/testsession1.hpp b/tests/core/proc/mobject/session/testsession1.hpp index 10490d14c..3e0f1fcf2 100644 --- a/tests/core/proc/mobject/session/testsession1.hpp +++ b/tests/core/proc/mobject/session/testsession1.hpp @@ -20,6 +20,10 @@ */ +/** @file §§§ + ** unit test TODO §§§ + */ + #ifndef MOBJECT_SESSION_TESTSESSION1_H #define MOBJECT_SESSION_TESTSESSION1_H diff --git a/tests/core/proc/mobject/session/timeline-sequence-handling-test.cpp b/tests/core/proc/mobject/session/timeline-sequence-handling-test.cpp index 044c675c4..4909379a0 100644 --- a/tests/core/proc/mobject/session/timeline-sequence-handling-test.cpp +++ b/tests/core/proc/mobject/session/timeline-sequence-handling-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "proc/mobject/session.hpp" diff --git a/tests/core/proc/play/dummy-play-connection-test.cpp b/tests/core/proc/play/dummy-play-connection-test.cpp index c9e0f1777..b6e326f44 100644 --- a/tests/core/proc/play/dummy-play-connection-test.cpp +++ b/tests/core/proc/play/dummy-play-connection-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/core/proc/play/output-slot-protocol-test.cpp b/tests/core/proc/play/output-slot-protocol-test.cpp index 739a920d4..e04b1bd11 100644 --- a/tests/core/proc/play/output-slot-protocol-test.cpp +++ b/tests/core/proc/play/output-slot-protocol-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/core/proc/play/timing-constraints-test.cpp b/tests/core/proc/play/timing-constraints-test.cpp index 99b890798..349940390 100644 --- a/tests/core/proc/play/timing-constraints-test.cpp +++ b/tests/core/proc/play/timing-constraints-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/gui/bus-term-test.cpp b/tests/gui/bus-term-test.cpp index 8e432b12d..b7ca88f49 100644 --- a/tests/gui/bus-term-test.cpp +++ b/tests/gui/bus-term-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/gui/interact/state-map-grouping-storage-test.cpp b/tests/gui/interact/state-map-grouping-storage-test.cpp index 9c0300d2a..0040ad415 100644 --- a/tests/gui/interact/state-map-grouping-storage-test.cpp +++ b/tests/gui/interact/state-map-grouping-storage-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/gui/test-gui-test.cpp b/tests/gui/test-gui-test.cpp index a022c7858..d5268b9a8 100644 --- a/tests/gui/test-gui-test.cpp +++ b/tests/gui/test-gui-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/util.hpp" diff --git a/tests/library/advice/advice-basics-test.cpp b/tests/library/advice/advice-basics-test.cpp index e5a65e532..6e989b6f5 100644 --- a/tests/library/advice/advice-basics-test.cpp +++ b/tests/library/advice/advice-basics-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "common/advice.hpp" diff --git a/tests/library/advice/advice-binding-pattern-test.cpp b/tests/library/advice/advice-binding-pattern-test.cpp index c25f7c81a..9671ea1ff 100644 --- a/tests/library/advice/advice-binding-pattern-test.cpp +++ b/tests/library/advice/advice-binding-pattern-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/library/advice/advice-configuration-test.cpp b/tests/library/advice/advice-configuration-test.cpp index 68a6ff697..c8ff0d4e7 100644 --- a/tests/library/advice/advice-configuration-test.cpp +++ b/tests/library/advice/advice-configuration-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" //#include "lib/test/test-helper.hpp" diff --git a/tests/library/advice/advice-index-test.cpp b/tests/library/advice/advice-index-test.cpp index 8eaf0bf11..8db4ce983 100644 --- a/tests/library/advice/advice-index-test.cpp +++ b/tests/library/advice/advice-index-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/hash-value.h" diff --git a/tests/library/advice/advice-multiplicity-test.cpp b/tests/library/advice/advice-multiplicity-test.cpp index f0641cdb4..b09f1e469 100644 --- a/tests/library/advice/advice-multiplicity-test.cpp +++ b/tests/library/advice/advice-multiplicity-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" //#include "lib/test/test-helper.hpp" diff --git a/tests/library/advice/advice-situations-test.cpp b/tests/library/advice/advice-situations-test.cpp index 292df259a..7f0d1b45a 100644 --- a/tests/library/advice/advice-situations-test.cpp +++ b/tests/library/advice/advice-situations-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" //#include "lib/test/test-helper.hpp" diff --git a/tests/library/allocation-cluster-test.cpp b/tests/library/allocation-cluster-test.cpp index cf1294d43..4dc49b8c8 100644 --- a/tests/library/allocation-cluster-test.cpp +++ b/tests/library/allocation-cluster-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/app-config-test.cpp b/tests/library/app-config-test.cpp index 5361abb40..2a19305ee 100644 --- a/tests/library/app-config-test.cpp +++ b/tests/library/app-config-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/bool-checkable-test.cpp b/tests/library/bool-checkable-test.cpp index c4f51b83a..cb9cfede3 100644 --- a/tests/library/bool-checkable-test.cpp +++ b/tests/library/bool-checkable-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/bool-checkable.hpp" diff --git a/tests/library/cmdline-wrapper-test.cpp b/tests/library/cmdline-wrapper-test.cpp index 0bbecf71d..8ca8de8ad 100644 --- a/tests/library/cmdline-wrapper-test.cpp +++ b/tests/library/cmdline-wrapper-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/cmdline.hpp" diff --git a/tests/library/custom-shared-ptr-test.cpp b/tests/library/custom-shared-ptr-test.cpp index 0ffdc9c61..4ec7493ce 100644 --- a/tests/library/custom-shared-ptr-test.cpp +++ b/tests/library/custom-shared-ptr-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/library/del-stash-test.cpp b/tests/library/del-stash-test.cpp index 5a157d1c8..28ff6dea4 100644 --- a/tests/library/del-stash-test.cpp +++ b/tests/library/del-stash-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/del-stash.hpp" diff --git a/tests/library/dependency-factory-test.cpp b/tests/library/dependency-factory-test.cpp index 95ed39890..5df8937a9 100644 --- a/tests/library/dependency-factory-test.cpp +++ b/tests/library/dependency-factory-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/diff/diff-complex-application-test.cpp b/tests/library/diff/diff-complex-application-test.cpp index 931340645..22d711540 100644 --- a/tests/library/diff/diff-complex-application-test.cpp +++ b/tests/library/diff/diff-complex-application-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/format-util.hpp" diff --git a/tests/library/diff/diff-index-table-test.cpp b/tests/library/diff/diff-index-table-test.cpp index 36ca475cb..01279b113 100644 --- a/tests/library/diff/diff-index-table-test.cpp +++ b/tests/library/diff/diff-index-table-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/library/diff/diff-list-application-test.cpp b/tests/library/diff/diff-list-application-test.cpp index f8bf3639c..a87f98fed 100644 --- a/tests/library/diff/diff-list-application-test.cpp +++ b/tests/library/diff/diff-list-application-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/diff/list-diff-application.hpp" diff --git a/tests/library/diff/diff-list-generation-test.cpp b/tests/library/diff/diff-list-generation-test.cpp index 26add3b3b..0e7af8746 100644 --- a/tests/library/diff/diff-list-generation-test.cpp +++ b/tests/library/diff/diff-list-generation-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/diff/list-diff-detector.hpp" diff --git a/tests/library/diff/diff-tree-application-test.cpp b/tests/library/diff/diff-tree-application-test.cpp index 439bd2c39..d640925d0 100644 --- a/tests/library/diff/diff-tree-application-test.cpp +++ b/tests/library/diff/diff-tree-application-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/format-util.hpp" diff --git a/tests/library/diff/gen-node-basic-test.cpp b/tests/library/diff/gen-node-basic-test.cpp index 31d569756..5c043d573 100644 --- a/tests/library/diff/gen-node-basic-test.cpp +++ b/tests/library/diff/gen-node-basic-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/library/diff/generic-record-representation-test.cpp b/tests/library/diff/generic-record-representation-test.cpp index 82a7e6ddb..562d917e7 100644 --- a/tests/library/diff/generic-record-representation-test.cpp +++ b/tests/library/diff/generic-record-representation-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/library/diff/tree-mutator-binding-test.cpp b/tests/library/diff/tree-mutator-binding-test.cpp index 0e680ac3a..4ad181975 100644 --- a/tests/library/diff/tree-mutator-binding-test.cpp +++ b/tests/library/diff/tree-mutator-binding-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/format-util.hpp" diff --git a/tests/library/diff/tree-mutator-test.cpp b/tests/library/diff/tree-mutator-test.cpp index 34ceb4b87..2cd8c7482 100644 --- a/tests/library/diff/tree-mutator-test.cpp +++ b/tests/library/diff/tree-mutator-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/format-util.hpp" diff --git a/tests/library/exceptionerrortest.cpp b/tests/library/exceptionerrortest.cpp index f19259b99..247458a5e 100644 --- a/tests/library/exceptionerrortest.cpp +++ b/tests/library/exceptionerrortest.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/error.h" diff --git a/tests/library/format-cout-test.cpp b/tests/library/format-cout-test.cpp index 047c71a43..ef020ebd9 100644 --- a/tests/library/format-cout-test.cpp +++ b/tests/library/format-cout-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/format-helper-test.cpp b/tests/library/format-helper-test.cpp index 753baebcb..44a2f57c3 100644 --- a/tests/library/format-helper-test.cpp +++ b/tests/library/format-helper-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/format-util.hpp" diff --git a/tests/library/format-string-test.cpp b/tests/library/format-string-test.cpp index 74408cddc..2577588e0 100644 --- a/tests/library/format-string-test.cpp +++ b/tests/library/format-string-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/library/functor-util-test.cpp b/tests/library/functor-util-test.cpp index f1f9446e9..6dda798be 100644 --- a/tests/library/functor-util-test.cpp +++ b/tests/library/functor-util-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/hash-generator-test.cpp b/tests/library/hash-generator-test.cpp index 4a494c094..2a9be98d4 100644 --- a/tests/library/hash-generator-test.cpp +++ b/tests/library/hash-generator-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/util.hpp" diff --git a/tests/library/hash-indexed-test.cpp b/tests/library/hash-indexed-test.cpp index f709389a4..cba68e9f2 100644 --- a/tests/library/hash-indexed-test.cpp +++ b/tests/library/hash-indexed-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/hash-standard-to-boost-bridge-test.cpp b/tests/library/hash-standard-to-boost-bridge-test.cpp index ff1cf2a08..97cd802b6 100644 --- a/tests/library/hash-standard-to-boost-bridge-test.cpp +++ b/tests/library/hash-standard-to-boost-bridge-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/hash-standard.hpp" diff --git a/tests/library/helloworldtest.cpp b/tests/library/helloworldtest.cpp index e61e948c4..e15c3368e 100644 --- a/tests/library/helloworldtest.cpp +++ b/tests/library/helloworldtest.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/util.hpp" diff --git a/tests/library/hierarchy-orientation-indicator-test.cpp b/tests/library/hierarchy-orientation-indicator-test.cpp index 76cae0cac..eac05f593 100644 --- a/tests/library/hierarchy-orientation-indicator-test.cpp +++ b/tests/library/hierarchy-orientation-indicator-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/idi/generic-id-function-test.cpp b/tests/library/idi/generic-id-function-test.cpp index 78537764d..e0da5427c 100644 --- a/tests/library/idi/generic-id-function-test.cpp +++ b/tests/library/idi/generic-id-function-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" //#include "lib/test/test-helper.hpp" diff --git a/tests/library/item-wrapper-test.cpp b/tests/library/item-wrapper-test.cpp index 44f707e1f..bc9eacff7 100644 --- a/tests/library/item-wrapper-test.cpp +++ b/tests/library/item-wrapper-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/iter-adapter-stl-test.cpp b/tests/library/iter-adapter-stl-test.cpp index 9ee927efa..6c46abba7 100644 --- a/tests/library/iter-adapter-stl-test.cpp +++ b/tests/library/iter-adapter-stl-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/iter-adapter-test.cpp b/tests/library/iter-adapter-test.cpp index b5aaea55f..4c7e2fd1a 100644 --- a/tests/library/iter-adapter-test.cpp +++ b/tests/library/iter-adapter-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/iter-cursor-test.cpp b/tests/library/iter-cursor-test.cpp index 28f3e5b85..38d1eecec 100644 --- a/tests/library/iter-cursor-test.cpp +++ b/tests/library/iter-cursor-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/iter-explorer-test.cpp b/tests/library/iter-explorer-test.cpp index f22981e8d..ffd0f2cf8 100644 --- a/tests/library/iter-explorer-test.cpp +++ b/tests/library/iter-explorer-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/iter-queue-test.cpp b/tests/library/iter-queue-test.cpp index b0a09a091..ab0df58f2 100644 --- a/tests/library/iter-queue-test.cpp +++ b/tests/library/iter-queue-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/iter-source-test.cpp b/tests/library/iter-source-test.cpp index 5993b2501..4074436f0 100644 --- a/tests/library/iter-source-test.cpp +++ b/tests/library/iter-source-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/iter-stack-test.cpp b/tests/library/iter-stack-test.cpp index 5a35e4280..fe41b7a28 100644 --- a/tests/library/iter-stack-test.cpp +++ b/tests/library/iter-stack-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/itertools-test.cpp b/tests/library/itertools-test.cpp index 04b1ba088..1e7b91859 100644 --- a/tests/library/itertools-test.cpp +++ b/tests/library/itertools-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/lifecycletest.cpp b/tests/library/lifecycletest.cpp index c437aa74b..14669c345 100644 --- a/tests/library/lifecycletest.cpp +++ b/tests/library/lifecycletest.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/linked-elements-test.cpp b/tests/library/linked-elements-test.cpp index dc843acce..ce78c29c1 100644 --- a/tests/library/linked-elements-test.cpp +++ b/tests/library/linked-elements-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/maybe-value-test.cpp b/tests/library/maybe-value-test.cpp index b739a68b9..99f8f0171 100644 --- a/tests/library/maybe-value-test.cpp +++ b/tests/library/maybe-value-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + diff --git a/tests/library/meta/access-casted-test.cpp b/tests/library/meta/access-casted-test.cpp index f0332b78e..90fef0367 100644 --- a/tests/library/meta/access-casted-test.cpp +++ b/tests/library/meta/access-casted-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/meta/duck-detector-test.cpp b/tests/library/meta/duck-detector-test.cpp index 78a4c5469..89e5287bc 100644 --- a/tests/library/meta/duck-detector-test.cpp +++ b/tests/library/meta/duck-detector-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/meta/duck-detector.hpp" diff --git a/tests/library/meta/dummy-functions.hpp b/tests/library/meta/dummy-functions.hpp index 2114ee6a9..0650c547e 100644 --- a/tests/library/meta/dummy-functions.hpp +++ b/tests/library/meta/dummy-functions.hpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #ifndef LIB_META_DUMMY_FUNCTIONS_H #define LIB_META_DUMMY_FUNCTIONS_H diff --git a/tests/library/meta/function-composition-test.cpp b/tests/library/meta/function-composition-test.cpp index 8e3df3aaa..16cf65cfb 100644 --- a/tests/library/meta/function-composition-test.cpp +++ b/tests/library/meta/function-composition-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/library/meta/function-erasure-test.cpp b/tests/library/meta/function-erasure-test.cpp index 11824da8e..712772312 100644 --- a/tests/library/meta/function-erasure-test.cpp +++ b/tests/library/meta/function-erasure-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/library/meta/generator-combinations-test.cpp b/tests/library/meta/generator-combinations-test.cpp index e63665502..629001e81 100644 --- a/tests/library/meta/generator-combinations-test.cpp +++ b/tests/library/meta/generator-combinations-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/meta/generator.hpp" diff --git a/tests/library/meta/iterable-classification-test.cpp b/tests/library/meta/iterable-classification-test.cpp index 8f0c5f4d4..681392401 100644 --- a/tests/library/meta/iterable-classification-test.cpp +++ b/tests/library/meta/iterable-classification-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/meta/meta-utils-test.cpp b/tests/library/meta/meta-utils-test.cpp index e71123f61..9de46d91f 100644 --- a/tests/library/meta/meta-utils-test.cpp +++ b/tests/library/meta/meta-utils-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/meta/util.hpp" diff --git a/tests/library/meta/tuple-record-init-test.cpp b/tests/library/meta/tuple-record-init-test.cpp index c9c305088..92f468172 100644 --- a/tests/library/meta/tuple-record-init-test.cpp +++ b/tests/library/meta/tuple-record-init-test.cpp @@ -19,6 +19,10 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. * *****************************************************/ + +/** @file §§§ + ** unit test TODO §§§ + */ ///@file diff --git a/tests/library/meta/type-demangling-test.cpp b/tests/library/meta/type-demangling-test.cpp index 8928fb3a3..3eb1cfa29 100644 --- a/tests/library/meta/type-demangling-test.cpp +++ b/tests/library/meta/type-demangling-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/meta/util.hpp" diff --git a/tests/library/meta/type-display-test.cpp b/tests/library/meta/type-display-test.cpp index 55dc4a56b..60565e275 100644 --- a/tests/library/meta/type-display-test.cpp +++ b/tests/library/meta/type-display-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/meta/typelist-test.cpp b/tests/library/meta/typelist-test.cpp index a1f9ede6f..ffb307cc0 100644 --- a/tests/library/meta/typelist-test.cpp +++ b/tests/library/meta/typelist-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/meta/typelist.hpp" diff --git a/tests/library/meta/typelist-util-test.cpp b/tests/library/meta/typelist-util-test.cpp index 55de3474b..6c9bdd79e 100644 --- a/tests/library/meta/typelist-util-test.cpp +++ b/tests/library/meta/typelist-util-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/meta/typelist-util.hpp" diff --git a/tests/library/meta/virtual-copy-support-test.cpp b/tests/library/meta/virtual-copy-support-test.cpp index eda331d68..4ca762b24 100644 --- a/tests/library/meta/virtual-copy-support-test.cpp +++ b/tests/library/meta/virtual-copy-support-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/multifact-argument-test.cpp b/tests/library/multifact-argument-test.cpp index 47fadd37a..f69244d76 100644 --- a/tests/library/multifact-argument-test.cpp +++ b/tests/library/multifact-argument-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/library/multifact-singleton-test.cpp b/tests/library/multifact-singleton-test.cpp index 08ce5e1eb..ade0f26d3 100644 --- a/tests/library/multifact-singleton-test.cpp +++ b/tests/library/multifact-singleton-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/library/multifact-test.cpp b/tests/library/multifact-test.cpp index 55e0e84fd..3b2b99d83 100644 --- a/tests/library/multifact-test.cpp +++ b/tests/library/multifact-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/library/null-value-test.cpp b/tests/library/null-value-test.cpp index af67e8ba9..785991044 100644 --- a/tests/library/null-value-test.cpp +++ b/tests/library/null-value-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + diff --git a/tests/library/opaque-holder-test.cpp b/tests/library/opaque-holder-test.cpp index da866abf2..4df609b04 100644 --- a/tests/library/opaque-holder-test.cpp +++ b/tests/library/opaque-holder-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/opaque-unchecked-buffer-test.cpp b/tests/library/opaque-unchecked-buffer-test.cpp index 6b6b74cd3..c8f0aeca5 100644 --- a/tests/library/opaque-unchecked-buffer-test.cpp +++ b/tests/library/opaque-unchecked-buffer-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/optional-ref-test.cpp b/tests/library/optional-ref-test.cpp index c061fb686..a568850ab 100644 --- a/tests/library/optional-ref-test.cpp +++ b/tests/library/optional-ref-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/polymorphic-value-test.cpp b/tests/library/polymorphic-value-test.cpp index 6da5cd81f..f824b0756 100644 --- a/tests/library/polymorphic-value-test.cpp +++ b/tests/library/polymorphic-value-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/query-text-test.cpp b/tests/library/query-text-test.cpp index d9fb8d19b..f7f9a3732 100644 --- a/tests/library/query-text-test.cpp +++ b/tests/library/query-text-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/query/query-utils-test.cpp b/tests/library/query/query-utils-test.cpp index 4e2b3eae6..b25d4eed0 100644 --- a/tests/library/query/query-utils-test.cpp +++ b/tests/library/query/query-utils-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/util.hpp" diff --git a/tests/library/ref-array-test.cpp b/tests/library/ref-array-test.cpp index 52734cd60..45980e1d0 100644 --- a/tests/library/ref-array-test.cpp +++ b/tests/library/ref-array-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/util.hpp" diff --git a/tests/library/removefromsettest.cpp b/tests/library/removefromsettest.cpp index fe4b14729..53ea9a2b2 100644 --- a/tests/library/removefromsettest.cpp +++ b/tests/library/removefromsettest.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/util-foreach.hpp" diff --git a/tests/library/sanitised-identifier-test.cpp b/tests/library/sanitised-identifier-test.cpp index a0b0d59de..e04288b72 100644 --- a/tests/library/sanitised-identifier-test.cpp +++ b/tests/library/sanitised-identifier-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/util.hpp" diff --git a/tests/library/scoped-collection-test.cpp b/tests/library/scoped-collection-test.cpp index 1c194b96c..87168a723 100644 --- a/tests/library/scoped-collection-test.cpp +++ b/tests/library/scoped-collection-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/scoped-holder-test.cpp b/tests/library/scoped-holder-test.cpp index ec921efc7..c3fe368f0 100644 --- a/tests/library/scoped-holder-test.cpp +++ b/tests/library/scoped-holder-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/scoped-holder-transfer-test.cpp b/tests/library/scoped-holder-transfer-test.cpp index f7c9a2e22..41f972d56 100644 --- a/tests/library/scoped-holder-transfer-test.cpp +++ b/tests/library/scoped-holder-transfer-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/scoped-ptrvect-test.cpp b/tests/library/scoped-ptrvect-test.cpp index 98b197485..0694b0538 100644 --- a/tests/library/scoped-ptrvect-test.cpp +++ b/tests/library/scoped-ptrvect-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/search-path-splitter-test.cpp b/tests/library/search-path-splitter-test.cpp index 5f9cd6d4b..5d5d19eb8 100644 --- a/tests/library/search-path-splitter-test.cpp +++ b/tests/library/search-path-splitter-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/library/simple-allocator-test.cpp b/tests/library/simple-allocator-test.cpp index 891a9020a..019baf77c 100644 --- a/tests/library/simple-allocator-test.cpp +++ b/tests/library/simple-allocator-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/simple-allocator.hpp" diff --git a/tests/library/singleton-subclass-test.cpp b/tests/library/singleton-subclass-test.cpp index 0fa36c40a..b661dcfd5 100644 --- a/tests/library/singleton-subclass-test.cpp +++ b/tests/library/singleton-subclass-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/library/singleton-test.cpp b/tests/library/singleton-test.cpp index dfe5c4998..90ab20ba0 100644 --- a/tests/library/singleton-test.cpp +++ b/tests/library/singleton-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/format-string.hpp" diff --git a/tests/library/singleton-testmock-test.cpp b/tests/library/singleton-testmock-test.cpp index a9ecc51f1..bf039c656 100644 --- a/tests/library/singleton-testmock-test.cpp +++ b/tests/library/singleton-testmock-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/sub-id-test.cpp b/tests/library/sub-id-test.cpp index 8b7ab938b..39af39831 100644 --- a/tests/library/sub-id-test.cpp +++ b/tests/library/sub-id-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/util.hpp" diff --git a/tests/library/symbol-hashtable-test.cpp b/tests/library/symbol-hashtable-test.cpp index 71aefef4d..00473540f 100644 --- a/tests/library/symbol-hashtable-test.cpp +++ b/tests/library/symbol-hashtable-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/symbol-test.cpp b/tests/library/symbol-test.cpp index 62bbb1ea6..de8ccbb1d 100644 --- a/tests/library/symbol-test.cpp +++ b/tests/library/symbol-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/library/test-target-obj.hpp b/tests/library/test-target-obj.hpp index 0f6279b3e..2e5412fb8 100644 --- a/tests/library/test-target-obj.hpp +++ b/tests/library/test-target-obj.hpp @@ -20,6 +20,10 @@ */ +/** @file §§§ + ** unit test TODO §§§ + */ + #ifndef LIBRARY_TEST_TARGET_OBJ_H #define LIBRARY_TEST_TARGET_OBJ_H diff --git a/tests/library/test/test-event-log-test.cpp b/tests/library/test/test-event-log-test.cpp index 5c60f9a0c..60e7c5f4c 100644 --- a/tests/library/test/test-event-log-test.cpp +++ b/tests/library/test/test-event-log-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/format-util.hpp" diff --git a/tests/library/test/test-helper-test.cpp b/tests/library/test/test-helper-test.cpp index a01bfc47f..8028364d0 100644 --- a/tests/library/test/test-helper-test.cpp +++ b/tests/library/test/test-helper-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/library/test/test-helper-variadic-test.cpp b/tests/library/test/test-helper-variadic-test.cpp index 99474557b..0cdf0a2fa 100644 --- a/tests/library/test/test-helper-variadic-test.cpp +++ b/tests/library/test/test-helper-variadic-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/library/test/test-option-test.cpp b/tests/library/test/test-option-test.cpp index b1fdc2032..01709fbaa 100644 --- a/tests/library/test/test-option-test.cpp +++ b/tests/library/test/test-option-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/testoption.hpp" diff --git a/tests/library/typed-allocation-manager-test.cpp b/tests/library/typed-allocation-manager-test.cpp index ef75edfd3..128d7da77 100644 --- a/tests/library/typed-allocation-manager-test.cpp +++ b/tests/library/typed-allocation-manager-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/typed-allocation-manager.hpp" diff --git a/tests/library/unique-malloc-owner-test.cpp b/tests/library/unique-malloc-owner-test.cpp index 199ae20cf..a75358dd3 100644 --- a/tests/library/unique-malloc-owner-test.cpp +++ b/tests/library/unique-malloc-owner-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/library/util-collection-test.cpp b/tests/library/util-collection-test.cpp index 65e773715..faaa4c925 100644 --- a/tests/library/util-collection-test.cpp +++ b/tests/library/util-collection-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/itertools.hpp" diff --git a/tests/library/util-floordiv-test.cpp b/tests/library/util-floordiv-test.cpp index 0ee9d4788..dac4c65bc 100644 --- a/tests/library/util-floordiv-test.cpp +++ b/tests/library/util-floordiv-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/util-quant.hpp" diff --git a/tests/library/util-floorwrap-test.cpp b/tests/library/util-floorwrap-test.cpp index e0eee28f1..bf49fabd7 100644 --- a/tests/library/util-floorwrap-test.cpp +++ b/tests/library/util-floorwrap-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/test/test-helper.hpp" diff --git a/tests/library/util-foreach-test.cpp b/tests/library/util-foreach-test.cpp index 5993ca209..7ee572813 100644 --- a/tests/library/util-foreach-test.cpp +++ b/tests/library/util-foreach-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/util-foreach.hpp" diff --git a/tests/library/variant-test.cpp b/tests/library/variant-test.cpp index 3532919c1..a231bdb80 100644 --- a/tests/library/variant-test.cpp +++ b/tests/library/variant-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/vector-transfer-test.cpp b/tests/library/vector-transfer-test.cpp index 143594342..8f0004ec1 100644 --- a/tests/library/vector-transfer-test.cpp +++ b/tests/library/vector-transfer-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/library/verb-function-dispatch-test.cpp b/tests/library/verb-function-dispatch-test.cpp index 5171154cd..ae23446fd 100644 --- a/tests/library/verb-function-dispatch-test.cpp +++ b/tests/library/verb-function-dispatch-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" #include "lib/verb-token.hpp" diff --git a/tests/operation/bugs/hello-bug-test.cpp b/tests/operation/bugs/hello-bug-test.cpp index 34f7e45fb..84ec29cd7 100644 --- a/tests/operation/bugs/hello-bug-test.cpp +++ b/tests/operation/bugs/hello-bug-test.cpp @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/run.hpp" diff --git a/tests/plugin/test-cpp-plugin/example_plugin.cpp b/tests/plugin/test-cpp-plugin/example_plugin.cpp index 8a32ac8e7..552a26c2f 100644 --- a/tests/plugin/test-cpp-plugin/example_plugin.cpp +++ b/tests/plugin/test-cpp-plugin/example_plugin.cpp @@ -21,6 +21,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "common/interface-descriptor.h" diff --git a/tests/testrunner.cpp b/tests/testrunner.cpp index ce0e2faed..8c9c91d24 100644 --- a/tests/testrunner.cpp +++ b/tests/testrunner.cpp @@ -21,6 +21,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "include/lifecycle.h" #include "lib/test/testoption.hpp" #include "lib/test/suite.hpp" From 6339a288dd2ca41f65db446f9510f3b892dff770 Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Thu, 3 Nov 2016 18:22:31 +0100 Subject: [PATCH 02/26] Doxygen: insert actual filename into those automatically added file comments MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit HOWTO for F in $(find src -type f \( -name '*.cpp' -or -name '*.hpp' \) -exec egrep -q '§§§' {} \; -print); do D=$(basename $F); sed -r -e"s/§§§/$D/" $F ; done --- src/backend/engine/engine-config.cpp | 4 ++-- src/backend/engine/scheduler-frontend.cpp | 4 ++-- src/backend/engine/scheduler-frontend.hpp | 4 ++-- src/backend/enginefacade.cpp | 4 ++-- src/backend/enginefacade.hpp | 4 ++-- src/backend/media-access-facade.cpp | 4 ++-- src/backend/media-access-facade.hpp | 4 ++-- src/backend/netnodefacade.cpp | 4 ++-- src/backend/netnodefacade.hpp | 4 ++-- src/backend/real-clock.cpp | 4 ++-- src/backend/scriptrunnerfacade.cpp | 4 ++-- src/backend/scriptrunnerfacade.hpp | 4 ++-- src/backend/thread-wrapper.hpp | 4 ++-- src/backend/threadpool-init.cpp | 4 ++-- src/common/advice/binding.cpp | 4 ++-- src/common/appstate.cpp | 4 ++-- src/common/basic-setup.cpp | 4 ++-- src/common/basic-setup.hpp | 4 ++-- src/common/configfacade.cpp | 4 ++-- src/common/guifacade.cpp | 4 ++-- src/common/interfaceproxy.cpp | 4 ++-- src/common/option.cpp | 4 ++-- src/common/option.hpp | 4 ++-- src/common/query/config-rules.cpp | 4 ++-- src/common/query/defs-manager.hpp | 4 ++-- src/common/query/query-resolver.cpp | 4 ++-- src/common/query/query-resolver.hpp | 4 ++-- src/common/subsys.cpp | 4 ++-- src/common/subsystem-runner.hpp | 4 ++-- src/gui/ctrl/playback-controller.cpp | 4 ++-- src/gui/dialog/dialog.hpp | 4 ++-- src/gui/dialog/name-chooser.cpp | 4 ++-- src/gui/dialog/name-chooser.hpp | 4 ++-- src/gui/dialog/preferences-dialog.hpp | 4 ++-- src/gui/dialog/render.cpp | 4 ++-- src/gui/display-service.cpp | 4 ++-- src/gui/gtk-lumiera.cpp | 4 ++-- src/gui/model/clip-track.cpp | 4 ++-- src/gui/model/clip.cpp | 4 ++-- src/gui/model/group-track.cpp | 4 ++-- src/gui/model/parent-track.cpp | 4 ++-- src/gui/model/project.cpp | 4 ++-- src/gui/model/sequence.cpp | 4 ++-- src/gui/model/track.cpp | 4 ++-- src/gui/notification-service.cpp | 4 ++-- src/gui/output/displayer.cpp | 4 ++-- src/gui/output/gdkdisplayer.cpp | 4 ++-- src/gui/output/xvdisplayer.cpp | 4 ++-- src/gui/panel/assets-panel.cpp | 4 ++-- src/gui/panel/assets-panel.hpp | 4 ++-- src/gui/panel/panel.cpp | 4 ++-- src/gui/panel/panel.hpp | 4 ++-- src/gui/panel/timeline-panel.cpp | 4 ++-- src/gui/panel/viewer-panel.cpp | 4 ++-- src/gui/ui-bus.cpp | 4 ++-- src/gui/util/cairo-util.cpp | 4 ++-- src/gui/util/cairo-util.hpp | 4 ++-- src/gui/util/rectangle.cpp | 4 ++-- src/gui/util/rectangle.hpp | 4 ++-- src/gui/widget/button-bar.cpp | 4 ++-- src/gui/widget/button-bar.hpp | 4 ++-- src/gui/widget/menu-button.cpp | 4 ++-- src/gui/widget/menu-button.hpp | 4 ++-- src/gui/widget/mini-button.hpp | 4 ++-- src/gui/widget/panel-bar.cpp | 4 ++-- src/gui/widget/timecode-widget.cpp | 4 ++-- src/gui/widget/timecode-widget.hpp | 4 ++-- src/gui/widget/timeline-widget.cpp | 4 ++-- src/gui/widget/timeline/basic-draw-strategy.hpp | 4 ++-- src/gui/widget/timeline/draw-strategy.cpp | 4 ++-- src/gui/widget/timeline/draw-strategy.hpp | 4 ++-- src/gui/widget/timeline/timeline-arrow-tool.cpp | 4 ++-- src/gui/widget/timeline/timeline-body.cpp | 4 ++-- src/gui/widget/timeline/timeline-clip-track.cpp | 4 ++-- src/gui/widget/timeline/timeline-clip.cpp | 4 ++-- src/gui/widget/timeline/timeline-entity.cpp | 4 ++-- src/gui/widget/timeline/timeline-group-track.cpp | 4 ++-- src/gui/widget/timeline/timeline-group-track.hpp | 4 ++-- src/gui/widget/timeline/timeline-header-container.cpp | 4 ++-- src/gui/widget/timeline/timeline-header-container.hpp | 4 ++-- src/gui/widget/timeline/timeline-header-widget.cpp | 4 ++-- src/gui/widget/timeline/timeline-header-widget.hpp | 4 ++-- src/gui/widget/timeline/timeline-ibeam-tool.cpp | 4 ++-- src/gui/widget/timeline/timeline-layout-helper.cpp | 4 ++-- src/gui/widget/timeline/timeline-ruler.cpp | 4 ++-- src/gui/widget/timeline/timeline-ruler.hpp | 4 ++-- src/gui/widget/timeline/timeline-state.cpp | 4 ++-- src/gui/widget/timeline/timeline-state.hpp | 4 ++-- src/gui/widget/timeline/timeline-tool.cpp | 4 ++-- src/gui/widget/timeline/timeline-tool.hpp | 4 ++-- src/gui/widget/timeline/timeline-track.cpp | 4 ++-- src/gui/widget/timeline/timeline-track.hpp | 4 ++-- src/gui/widget/timeline/timeline-view-window.cpp | 4 ++-- src/gui/widget/timeline/timeline-view-window.hpp | 4 ++-- src/gui/widget/timeline/timeline-zoom-scale.cpp | 4 ++-- src/gui/widget/timeline/timeline-zoom-scale.hpp | 4 ++-- src/gui/widget/video-display-widget.cpp | 4 ++-- src/gui/widget/video-display-widget.hpp | 4 ++-- src/gui/window-manager.cpp | 4 ++-- src/gui/workspace/actions.cpp | 4 ++-- src/gui/workspace/panel-manager.cpp | 4 ++-- src/gui/workspace/workspace-window.cpp | 4 ++-- src/lib/allocation-cluster.cpp | 4 ++-- src/lib/bool-checkable.hpp | 4 ++-- src/lib/cmdline.cpp | 4 ++-- src/lib/cmdline.hpp | 4 ++-- src/lib/dependency-factory.hpp | 4 ++-- src/lib/frameid.hpp | 4 ++-- src/lib/idi/genfunc.cpp | 4 ++-- src/lib/lifecycle.cpp | 4 ++-- src/lib/meta/maybe-compare.hpp | 4 ++-- src/lib/meta/no-instance.hpp | 4 ++-- src/lib/meta/size-trait.hpp | 4 ++-- src/lib/meta/trait-special.hpp | 4 ++-- src/lib/nobug-init.cpp | 4 ++-- src/lib/nocopy.hpp | 4 ++-- src/lib/optional-ref.hpp | 4 ++-- src/lib/query-diagnostics.hpp | 4 ++-- src/lib/query-text.cpp | 4 ++-- src/lib/query-util.cpp | 4 ++-- src/lib/query-util.hpp | 4 ++-- src/lib/ref-array.hpp | 4 ++-- src/lib/scoped-holder-transfer.hpp | 4 ++-- src/lib/searchpath.cpp | 4 ++-- src/lib/searchpath.hpp | 4 ++-- src/lib/test/depend-4test.hpp | 4 ++-- src/lib/test/event-log.cpp | 4 ++-- src/lib/test/suite.cpp | 4 ++-- src/lib/test/test-coll.hpp | 4 ++-- src/lib/test/testdummy.hpp | 4 ++-- src/lib/test/testoption.cpp | 4 ++-- src/lib/test/testoption.hpp | 4 ++-- src/lib/time/formats.hpp | 4 ++-- src/lib/time/grid.hpp | 4 ++-- src/lib/time/quantiser.cpp | 4 ++-- src/lib/time/quantiser.hpp | 4 ++-- src/lib/time/timecode.cpp | 4 ++-- src/lib/time/timecode.hpp | 4 ++-- src/lib/time/timequant.hpp | 4 ++-- src/lib/util-quant.hpp | 4 ++-- src/lib/util.cpp | 4 ++-- src/lib/util.hpp | 4 ++-- src/lib/visitor-dispatcher.hpp | 4 ++-- src/lib/wrapperptr.hpp | 4 ++-- src/lumiera/main.cpp | 4 ++-- src/proc/asset.cpp | 4 ++-- src/proc/asset/category.cpp | 4 ++-- src/proc/asset/category.hpp | 4 ++-- src/proc/asset/clip.cpp | 4 ++-- src/proc/asset/clip.hpp | 4 ++-- src/proc/asset/codec.cpp | 4 ++-- src/proc/asset/codec.hpp | 4 ++-- src/proc/asset/compoundmedia.cpp | 4 ++-- src/proc/asset/compoundmedia.hpp | 4 ++-- src/proc/asset/dataset.hpp | 4 ++-- src/proc/asset/db.hpp | 4 ++-- src/proc/asset/effect.cpp | 4 ++-- src/proc/asset/effect.hpp | 4 ++-- src/proc/asset/inventory.hpp | 4 ++-- src/proc/asset/media.cpp | 4 ++-- src/proc/asset/meta.cpp | 4 ++-- src/proc/asset/meta/time-grid.cpp | 4 ++-- src/proc/asset/pipe.cpp | 4 ++-- src/proc/asset/pipe.hpp | 4 ++-- src/proc/asset/preview.cpp | 4 ++-- src/proc/asset/preview.hpp | 4 ++-- src/proc/asset/proc.cpp | 4 ++-- src/proc/asset/procpatt.cpp | 4 ++-- src/proc/asset/procpatt.hpp | 4 ++-- src/proc/asset/sequence.cpp | 4 ++-- src/proc/asset/struct.cpp | 4 ++-- src/proc/asset/timeline.cpp | 4 ++-- src/proc/asset/typed-lookup.cpp | 4 ++-- src/proc/asset/unknown.cpp | 4 ++-- src/proc/asset/unknown.hpp | 4 ++-- src/proc/asset/viewer.cpp | 4 ++-- src/proc/assetmanager.cpp | 4 ++-- src/proc/config-resolver.cpp | 4 ++-- src/proc/control/argument-erasure.hpp | 4 ++-- src/proc/control/handling-pattern.cpp | 4 ++-- src/proc/control/mediaimpllib.hpp | 4 ++-- src/proc/control/pathmanager.cpp | 4 ++-- src/proc/control/pathmanager.hpp | 4 ++-- src/proc/control/proc-dispatcher.cpp | 4 ++-- src/proc/control/stypemanager.cpp | 4 ++-- src/proc/control/stypemanager.hpp | 4 ++-- src/proc/controllerfacade.cpp | 4 ++-- src/proc/controllerfacade.hpp | 4 ++-- src/proc/engine/buffer-local-key.hpp | 4 ++-- src/proc/engine/buffer-provider.cpp | 4 ++-- src/proc/engine/bufftable-obsolete.hpp | 4 ++-- src/proc/engine/bufftable.hpp | 4 ++-- src/proc/engine/calc-plan-continuation.cpp | 4 ++-- src/proc/engine/calc-plan-continuation.hpp | 4 ++-- src/proc/engine/calc-stream.hpp | 4 ++-- src/proc/engine/diagnostic-buffer-provider.cpp | 4 ++-- src/proc/engine/dispatch-table.cpp | 4 ++-- src/proc/engine/dispatch-table.hpp | 4 ++-- src/proc/engine/dispatcher.cpp | 4 ++-- src/proc/engine/dispatcher.hpp | 4 ++-- src/proc/engine/engine-service-mock.cpp | 4 ++-- src/proc/engine/engine-service.cpp | 4 ++-- src/proc/engine/frame-coord.hpp | 4 ++-- src/proc/engine/job-ticket.hpp | 4 ++-- src/proc/engine/link.cpp | 4 ++-- src/proc/engine/link.hpp | 4 ++-- src/proc/engine/mask.cpp | 4 ++-- src/proc/engine/mask.hpp | 4 ++-- src/proc/engine/nodefactory.cpp | 4 ++-- src/proc/engine/nodefactory.hpp | 4 ++-- src/proc/engine/nodewiring.cpp | 4 ++-- src/proc/engine/nodewiring.hpp | 4 ++-- src/proc/engine/pluginadapter.cpp | 4 ++-- src/proc/engine/pluginadapter.hpp | 4 ++-- src/proc/engine/render-invocation.cpp | 4 ++-- src/proc/engine/renderengine.cpp | 4 ++-- src/proc/engine/renderengine.hpp | 4 ++-- src/proc/engine/rendergraph.cpp | 4 ++-- src/proc/engine/rendergraph.hpp | 4 ++-- src/proc/engine/source.cpp | 4 ++-- src/proc/engine/source.hpp | 4 ++-- src/proc/engine/stateproxy.cpp | 4 ++-- src/proc/engine/stateproxy.hpp | 4 ++-- src/proc/engine/time-anchor.hpp | 4 ++-- src/proc/engine/tracking-heap-block-provider.cpp | 4 ++-- src/proc/engine/worker/dummy-image-generator.cpp | 4 ++-- src/proc/external/libgavl.cpp | 4 ++-- src/proc/external/libgavl.hpp | 4 ++-- src/proc/facade.cpp | 4 ++-- src/proc/mobject/builder/assembler.cpp | 4 ++-- src/proc/mobject/builder/assembler.hpp | 4 ++-- src/proc/mobject/builder/common.hpp | 4 ++-- src/proc/mobject/builder/conmanager.cpp | 4 ++-- src/proc/mobject/builder/conmanager.hpp | 4 ++-- src/proc/mobject/builder/mould.hpp | 4 ++-- src/proc/mobject/builder/nodecreatortool.cpp | 4 ++-- src/proc/mobject/builder/nodecreatortool.hpp | 4 ++-- src/proc/mobject/builder/operationpoint.cpp | 4 ++-- src/proc/mobject/builder/operationpoint.hpp | 4 ++-- src/proc/mobject/builder/renderstate.hpp | 4 ++-- src/proc/mobject/builder/segmentation-tool.cpp | 4 ++-- src/proc/mobject/builder/segmentation-tool.hpp | 4 ++-- src/proc/mobject/builder/toolfactory.cpp | 4 ++-- src/proc/mobject/builder/toolfactory.hpp | 4 ++-- src/proc/mobject/builder/wiringrequest.hpp | 4 ++-- src/proc/mobject/builderfacade.cpp | 4 ++-- src/proc/mobject/builderfacade.hpp | 4 ++-- src/proc/mobject/explicitplacement.hpp | 4 ++-- src/proc/mobject/interpolator.cpp | 4 ++-- src/proc/mobject/interpolator.hpp | 4 ++-- src/proc/mobject/mobject.cpp | 4 ++-- src/proc/mobject/mobject.hpp | 4 ++-- src/proc/mobject/output-designation.hpp | 4 ++-- src/proc/mobject/parameter.cpp | 4 ++-- src/proc/mobject/parameter.hpp | 4 ++-- src/proc/mobject/paramprovider.cpp | 4 ++-- src/proc/mobject/paramprovider.hpp | 4 ++-- src/proc/mobject/placement.cpp | 4 ++-- src/proc/mobject/session/abstractmo.cpp | 4 ++-- src/proc/mobject/session/abstractmo.hpp | 4 ++-- src/proc/mobject/session/allocation.cpp | 4 ++-- src/proc/mobject/session/allocation.hpp | 4 ++-- src/proc/mobject/session/auto.cpp | 4 ++-- src/proc/mobject/session/auto.hpp | 4 ++-- src/proc/mobject/session/binding.cpp | 4 ++-- src/proc/mobject/session/binding.hpp | 4 ++-- src/proc/mobject/session/bus-mo.cpp | 4 ++-- src/proc/mobject/session/bus-mo.hpp | 4 ++-- src/proc/mobject/session/clip.cpp | 4 ++-- src/proc/mobject/session/clip.hpp | 4 ++-- src/proc/mobject/session/constraint.cpp | 4 ++-- src/proc/mobject/session/constraint.hpp | 4 ++-- src/proc/mobject/session/effect.cpp | 4 ++-- src/proc/mobject/session/effect.hpp | 4 ++-- src/proc/mobject/session/element-query.hpp | 4 ++-- src/proc/mobject/session/fixedlocation.cpp | 4 ++-- src/proc/mobject/session/fixedlocation.hpp | 4 ++-- src/proc/mobject/session/fixture.cpp | 4 ++-- src/proc/mobject/session/fixture.hpp | 4 ++-- src/proc/mobject/session/fork.cpp | 4 ++-- src/proc/mobject/session/fork.hpp | 4 ++-- src/proc/mobject/session/generator-mo.cpp | 4 ++-- src/proc/mobject/session/generator-mo.hpp | 4 ++-- src/proc/mobject/session/label.cpp | 4 ++-- src/proc/mobject/session/label.hpp | 4 ++-- src/proc/mobject/session/locatingpin.cpp | 4 ++-- src/proc/mobject/session/meta.cpp | 4 ++-- src/proc/mobject/session/meta.hpp | 4 ++-- src/proc/mobject/session/mobjectfactory.cpp | 4 ++-- src/proc/mobject/session/mobjectfactory.hpp | 4 ++-- src/proc/mobject/session/placement-index-query-resolver.cpp | 4 ++-- src/proc/mobject/session/plug.cpp | 4 ++-- src/proc/mobject/session/plug.hpp | 4 ++-- src/proc/mobject/session/query-focus-stack.hpp | 4 ++-- src/proc/mobject/session/query-focus.cpp | 4 ++-- src/proc/mobject/session/query-focus.hpp | 4 ++-- src/proc/mobject/session/query/fake-configrules.cpp | 4 ++-- src/proc/mobject/session/relativelocation.cpp | 4 ++-- src/proc/mobject/session/relativelocation.hpp | 4 ++-- src/proc/mobject/session/root.cpp | 4 ++-- src/proc/mobject/session/root.hpp | 4 ++-- src/proc/mobject/session/scope-locator.hpp | 4 ++-- src/proc/mobject/session/scope-path.cpp | 4 ++-- src/proc/mobject/session/scope.hpp | 4 ++-- src/proc/mobject/session/segment.cpp | 4 ++-- src/proc/mobject/session/segment.hpp | 4 ++-- src/proc/mobject/session/segmentation.cpp | 4 ++-- src/proc/mobject/session/segmentation.hpp | 4 ++-- src/proc/mobject/session/sess-manager-impl.hpp | 4 ++-- src/proc/mobject/session/session-impl.cpp | 4 ++-- src/proc/mobject/session/session-services.cpp | 4 ++-- src/proc/mobject/session/specific-contents-query.hpp | 4 ++-- src/proc/mobject/session/wish.cpp | 4 ++-- src/proc/mobject/session/wish.hpp | 4 ++-- src/proc/play/dummy-play-connection.cpp | 4 ++-- src/proc/play/dummy-player-service.cpp | 4 ++-- src/proc/play/output-director.cpp | 4 ++-- src/proc/play/output-slot.cpp | 4 ++-- src/proc/play/play-process.cpp | 4 ++-- src/proc/play/play-service.cpp | 4 ++-- src/proc/play/render-configurator.cpp | 4 ++-- src/proc/play/sound/jack-output.cpp | 4 ++-- src/proc/play/timings.cpp | 4 ++-- src/proc/state.cpp | 4 ++-- src/proc/state.hpp | 4 ++-- src/proc/streamtype.cpp | 4 ++-- 326 files changed, 652 insertions(+), 652 deletions(-) diff --git a/src/backend/engine/engine-config.cpp b/src/backend/engine/engine-config.cpp index 8eaa421ba..3d14a93ec 100644 --- a/src/backend/engine/engine-config.cpp +++ b/src/backend/engine/engine-config.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file engine-config.cpp + ** TODO engine-config.cpp */ diff --git a/src/backend/engine/scheduler-frontend.cpp b/src/backend/engine/scheduler-frontend.cpp index e79823723..2e38a6bd0 100644 --- a/src/backend/engine/scheduler-frontend.cpp +++ b/src/backend/engine/scheduler-frontend.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file scheduler-frontend.cpp + ** TODO scheduler-frontend.cpp */ diff --git a/src/backend/engine/scheduler-frontend.hpp b/src/backend/engine/scheduler-frontend.hpp index cdf356e47..ad8a4fb56 100644 --- a/src/backend/engine/scheduler-frontend.hpp +++ b/src/backend/engine/scheduler-frontend.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file scheduler-frontend.hpp + ** TODO scheduler-frontend.hpp */ diff --git a/src/backend/enginefacade.cpp b/src/backend/enginefacade.cpp index d147bfb72..14aa9e0d1 100644 --- a/src/backend/enginefacade.cpp +++ b/src/backend/enginefacade.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file enginefacade.cpp + ** TODO enginefacade.cpp */ diff --git a/src/backend/enginefacade.hpp b/src/backend/enginefacade.hpp index b09cceefd..0a4d1604c 100644 --- a/src/backend/enginefacade.hpp +++ b/src/backend/enginefacade.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file enginefacade.hpp + ** TODO enginefacade.hpp */ diff --git a/src/backend/media-access-facade.cpp b/src/backend/media-access-facade.cpp index fd6227fc5..00906d0fd 100644 --- a/src/backend/media-access-facade.cpp +++ b/src/backend/media-access-facade.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file media-access-facade.cpp + ** TODO media-access-facade.cpp */ diff --git a/src/backend/media-access-facade.hpp b/src/backend/media-access-facade.hpp index a3e5fcf2b..abfe4ae6b 100644 --- a/src/backend/media-access-facade.hpp +++ b/src/backend/media-access-facade.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file media-access-facade.hpp + ** TODO media-access-facade.hpp */ diff --git a/src/backend/netnodefacade.cpp b/src/backend/netnodefacade.cpp index 5e0d11a49..a91662164 100644 --- a/src/backend/netnodefacade.cpp +++ b/src/backend/netnodefacade.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file netnodefacade.cpp + ** TODO netnodefacade.cpp */ diff --git a/src/backend/netnodefacade.hpp b/src/backend/netnodefacade.hpp index 8b037c728..e759a579c 100644 --- a/src/backend/netnodefacade.hpp +++ b/src/backend/netnodefacade.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file netnodefacade.hpp + ** TODO netnodefacade.hpp */ diff --git a/src/backend/real-clock.cpp b/src/backend/real-clock.cpp index d8ceace8c..b7865c232 100644 --- a/src/backend/real-clock.cpp +++ b/src/backend/real-clock.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file real-clock.cpp + ** TODO real-clock.cpp */ diff --git a/src/backend/scriptrunnerfacade.cpp b/src/backend/scriptrunnerfacade.cpp index 6797b59cf..90663edd1 100644 --- a/src/backend/scriptrunnerfacade.cpp +++ b/src/backend/scriptrunnerfacade.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file scriptrunnerfacade.cpp + ** TODO scriptrunnerfacade.cpp */ diff --git a/src/backend/scriptrunnerfacade.hpp b/src/backend/scriptrunnerfacade.hpp index 75bf420b0..19a5cb40f 100644 --- a/src/backend/scriptrunnerfacade.hpp +++ b/src/backend/scriptrunnerfacade.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file scriptrunnerfacade.hpp + ** TODO scriptrunnerfacade.hpp */ diff --git a/src/backend/thread-wrapper.hpp b/src/backend/thread-wrapper.hpp index d395625a8..7165d314f 100644 --- a/src/backend/thread-wrapper.hpp +++ b/src/backend/thread-wrapper.hpp @@ -22,8 +22,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file thread-wrapper.hpp + ** TODO thread-wrapper.hpp */ diff --git a/src/backend/threadpool-init.cpp b/src/backend/threadpool-init.cpp index f2c57c942..296b65ade 100644 --- a/src/backend/threadpool-init.cpp +++ b/src/backend/threadpool-init.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file threadpool-init.cpp + ** TODO threadpool-init.cpp */ diff --git a/src/common/advice/binding.cpp b/src/common/advice/binding.cpp index e5197d98f..b18436829 100644 --- a/src/common/advice/binding.cpp +++ b/src/common/advice/binding.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file binding.cpp + ** TODO binding.cpp */ diff --git a/src/common/appstate.cpp b/src/common/appstate.cpp index d8ff7f360..1f0a5b0af 100644 --- a/src/common/appstate.cpp +++ b/src/common/appstate.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file appstate.cpp + ** TODO appstate.cpp */ diff --git a/src/common/basic-setup.cpp b/src/common/basic-setup.cpp index fd2ac1055..f56cf256f 100644 --- a/src/common/basic-setup.cpp +++ b/src/common/basic-setup.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file basic-setup.cpp + ** TODO basic-setup.cpp */ diff --git a/src/common/basic-setup.hpp b/src/common/basic-setup.hpp index 33c0e61af..e9d4d67c9 100644 --- a/src/common/basic-setup.hpp +++ b/src/common/basic-setup.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file basic-setup.hpp + ** TODO basic-setup.hpp */ diff --git a/src/common/configfacade.cpp b/src/common/configfacade.cpp index 40fc94974..cdaaebd0e 100644 --- a/src/common/configfacade.cpp +++ b/src/common/configfacade.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file configfacade.cpp + ** TODO configfacade.cpp */ diff --git a/src/common/guifacade.cpp b/src/common/guifacade.cpp index 88041404a..1f5598c7b 100644 --- a/src/common/guifacade.cpp +++ b/src/common/guifacade.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file guifacade.cpp + ** TODO guifacade.cpp */ diff --git a/src/common/interfaceproxy.cpp b/src/common/interfaceproxy.cpp index 8fd627b42..d90b5e079 100644 --- a/src/common/interfaceproxy.cpp +++ b/src/common/interfaceproxy.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file interfaceproxy.cpp + ** TODO interfaceproxy.cpp */ diff --git a/src/common/option.cpp b/src/common/option.cpp index 6d4c78044..fc37f6107 100644 --- a/src/common/option.cpp +++ b/src/common/option.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file option.cpp + ** TODO option.cpp */ diff --git a/src/common/option.hpp b/src/common/option.hpp index 38ae06c60..f010e6635 100644 --- a/src/common/option.hpp +++ b/src/common/option.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file option.hpp + ** TODO option.hpp */ diff --git a/src/common/query/config-rules.cpp b/src/common/query/config-rules.cpp index 033603f1d..a7a7149df 100644 --- a/src/common/query/config-rules.cpp +++ b/src/common/query/config-rules.cpp @@ -22,8 +22,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file config-rules.cpp + ** TODO config-rules.cpp */ diff --git a/src/common/query/defs-manager.hpp b/src/common/query/defs-manager.hpp index ab58d5251..16fb2baba 100644 --- a/src/common/query/defs-manager.hpp +++ b/src/common/query/defs-manager.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file defs-manager.hpp + ** TODO defs-manager.hpp */ diff --git a/src/common/query/query-resolver.cpp b/src/common/query/query-resolver.cpp index 76cc0acaa..2d974c556 100644 --- a/src/common/query/query-resolver.cpp +++ b/src/common/query/query-resolver.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file query-resolver.cpp + ** TODO query-resolver.cpp */ diff --git a/src/common/query/query-resolver.hpp b/src/common/query/query-resolver.hpp index eab400f61..f7f831c73 100644 --- a/src/common/query/query-resolver.hpp +++ b/src/common/query/query-resolver.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file query-resolver.hpp + ** TODO query-resolver.hpp */ diff --git a/src/common/subsys.cpp b/src/common/subsys.cpp index 4c8202ab5..072cb6338 100644 --- a/src/common/subsys.cpp +++ b/src/common/subsys.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file subsys.cpp + ** TODO subsys.cpp */ diff --git a/src/common/subsystem-runner.hpp b/src/common/subsystem-runner.hpp index 8927c8e2f..f08c163d7 100644 --- a/src/common/subsystem-runner.hpp +++ b/src/common/subsystem-runner.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file subsystem-runner.hpp + ** TODO subsystem-runner.hpp */ diff --git a/src/gui/ctrl/playback-controller.cpp b/src/gui/ctrl/playback-controller.cpp index 8fe1bd400..40565a640 100644 --- a/src/gui/ctrl/playback-controller.cpp +++ b/src/gui/ctrl/playback-controller.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file playback-controller.cpp + ** TODO playback-controller.cpp */ diff --git a/src/gui/dialog/dialog.hpp b/src/gui/dialog/dialog.hpp index 8d669c778..89d3c8d1a 100644 --- a/src/gui/dialog/dialog.hpp +++ b/src/gui/dialog/dialog.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file dialog.hpp + ** TODO dialog.hpp */ diff --git a/src/gui/dialog/name-chooser.cpp b/src/gui/dialog/name-chooser.cpp index 0b057b10d..8fb9d2556 100644 --- a/src/gui/dialog/name-chooser.cpp +++ b/src/gui/dialog/name-chooser.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file name-chooser.cpp + ** TODO name-chooser.cpp */ diff --git a/src/gui/dialog/name-chooser.hpp b/src/gui/dialog/name-chooser.hpp index 903adf63b..bbba4a9eb 100644 --- a/src/gui/dialog/name-chooser.hpp +++ b/src/gui/dialog/name-chooser.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file name-chooser.hpp + ** TODO name-chooser.hpp */ diff --git a/src/gui/dialog/preferences-dialog.hpp b/src/gui/dialog/preferences-dialog.hpp index e25f3f43c..6dc45af36 100644 --- a/src/gui/dialog/preferences-dialog.hpp +++ b/src/gui/dialog/preferences-dialog.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file preferences-dialog.hpp + ** TODO preferences-dialog.hpp */ diff --git a/src/gui/dialog/render.cpp b/src/gui/dialog/render.cpp index 0d47c3b10..227f82ab2 100644 --- a/src/gui/dialog/render.cpp +++ b/src/gui/dialog/render.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file render.cpp + ** TODO render.cpp */ diff --git a/src/gui/display-service.cpp b/src/gui/display-service.cpp index 577307091..7efe02482 100644 --- a/src/gui/display-service.cpp +++ b/src/gui/display-service.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file display-service.cpp + ** TODO display-service.cpp */ diff --git a/src/gui/gtk-lumiera.cpp b/src/gui/gtk-lumiera.cpp index 3dc27ddae..a4b0cd1e3 100644 --- a/src/gui/gtk-lumiera.cpp +++ b/src/gui/gtk-lumiera.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file gtk-lumiera.cpp + ** TODO gtk-lumiera.cpp */ diff --git a/src/gui/model/clip-track.cpp b/src/gui/model/clip-track.cpp index fa68ff3af..dd4bdf086 100644 --- a/src/gui/model/clip-track.cpp +++ b/src/gui/model/clip-track.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file clip-track.cpp + ** TODO clip-track.cpp */ #include "clip-track.hpp" diff --git a/src/gui/model/clip.cpp b/src/gui/model/clip.cpp index 6c695c8f9..59c2fd21f 100644 --- a/src/gui/model/clip.cpp +++ b/src/gui/model/clip.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file clip.cpp + ** TODO clip.cpp */ diff --git a/src/gui/model/group-track.cpp b/src/gui/model/group-track.cpp index b031c64b3..b27e6e6e2 100644 --- a/src/gui/model/group-track.cpp +++ b/src/gui/model/group-track.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file group-track.cpp + ** TODO group-track.cpp */ #include "group-track.hpp" diff --git a/src/gui/model/parent-track.cpp b/src/gui/model/parent-track.cpp index 5865f3720..2326c96aa 100644 --- a/src/gui/model/parent-track.cpp +++ b/src/gui/model/parent-track.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file parent-track.cpp + ** TODO parent-track.cpp */ #include "parent-track.hpp" diff --git a/src/gui/model/project.cpp b/src/gui/model/project.cpp index f79c03402..cbe77efcb 100644 --- a/src/gui/model/project.cpp +++ b/src/gui/model/project.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file project.cpp + ** TODO project.cpp */ diff --git a/src/gui/model/sequence.cpp b/src/gui/model/sequence.cpp index addb8c817..f66be26c5 100644 --- a/src/gui/model/sequence.cpp +++ b/src/gui/model/sequence.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file sequence.cpp + ** TODO sequence.cpp */ #include "gui/model/sequence.hpp" diff --git a/src/gui/model/track.cpp b/src/gui/model/track.cpp index 3b89062a5..d493a0039 100644 --- a/src/gui/model/track.cpp +++ b/src/gui/model/track.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file track.cpp + ** TODO track.cpp */ diff --git a/src/gui/notification-service.cpp b/src/gui/notification-service.cpp index 8dcfe35e8..ce73cf52b 100644 --- a/src/gui/notification-service.cpp +++ b/src/gui/notification-service.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file notification-service.cpp + ** TODO notification-service.cpp */ diff --git a/src/gui/output/displayer.cpp b/src/gui/output/displayer.cpp index bd7893e15..551fd35f3 100644 --- a/src/gui/output/displayer.cpp +++ b/src/gui/output/displayer.cpp @@ -23,8 +23,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file displayer.cpp + ** TODO displayer.cpp */ diff --git a/src/gui/output/gdkdisplayer.cpp b/src/gui/output/gdkdisplayer.cpp index 6cfa0cd20..c088c602f 100644 --- a/src/gui/output/gdkdisplayer.cpp +++ b/src/gui/output/gdkdisplayer.cpp @@ -23,8 +23,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file gdkdisplayer.cpp + ** TODO gdkdisplayer.cpp */ diff --git a/src/gui/output/xvdisplayer.cpp b/src/gui/output/xvdisplayer.cpp index c958da31e..583330c41 100644 --- a/src/gui/output/xvdisplayer.cpp +++ b/src/gui/output/xvdisplayer.cpp @@ -23,8 +23,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file xvdisplayer.cpp + ** TODO xvdisplayer.cpp */ diff --git a/src/gui/panel/assets-panel.cpp b/src/gui/panel/assets-panel.cpp index 2712de02d..1bc90b833 100644 --- a/src/gui/panel/assets-panel.cpp +++ b/src/gui/panel/assets-panel.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file assets-panel.cpp + ** TODO assets-panel.cpp */ #include "gui/gtk-lumiera.hpp" diff --git a/src/gui/panel/assets-panel.hpp b/src/gui/panel/assets-panel.hpp index 46b5507fa..6e0d9945d 100644 --- a/src/gui/panel/assets-panel.hpp +++ b/src/gui/panel/assets-panel.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file assets-panel.hpp + ** TODO assets-panel.hpp */ diff --git a/src/gui/panel/panel.cpp b/src/gui/panel/panel.cpp index e911cdf1c..766e55129 100644 --- a/src/gui/panel/panel.cpp +++ b/src/gui/panel/panel.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file panel.cpp + ** TODO panel.cpp */ diff --git a/src/gui/panel/panel.hpp b/src/gui/panel/panel.hpp index 6379d262e..d059c526a 100644 --- a/src/gui/panel/panel.hpp +++ b/src/gui/panel/panel.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file panel.hpp + ** TODO panel.hpp */ diff --git a/src/gui/panel/timeline-panel.cpp b/src/gui/panel/timeline-panel.cpp index 676894c3a..d7659ad92 100644 --- a/src/gui/panel/timeline-panel.cpp +++ b/src/gui/panel/timeline-panel.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timeline-panel.cpp + ** TODO timeline-panel.cpp */ diff --git a/src/gui/panel/viewer-panel.cpp b/src/gui/panel/viewer-panel.cpp index bf359cae6..a7dad5ccb 100644 --- a/src/gui/panel/viewer-panel.cpp +++ b/src/gui/panel/viewer-panel.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file viewer-panel.cpp + ** TODO viewer-panel.cpp */ #include "gui/gtk-lumiera.hpp" diff --git a/src/gui/ui-bus.cpp b/src/gui/ui-bus.cpp index 6a1399cd6..d22dc2a27 100644 --- a/src/gui/ui-bus.cpp +++ b/src/gui/ui-bus.cpp @@ -22,8 +22,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file ui-bus.cpp + ** TODO ui-bus.cpp */ diff --git a/src/gui/util/cairo-util.cpp b/src/gui/util/cairo-util.cpp index 95d4a3725..936c2dec8 100644 --- a/src/gui/util/cairo-util.cpp +++ b/src/gui/util/cairo-util.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file cairo-util.cpp + ** TODO cairo-util.cpp */ diff --git a/src/gui/util/cairo-util.hpp b/src/gui/util/cairo-util.hpp index 9038cc95e..a9702a942 100644 --- a/src/gui/util/cairo-util.hpp +++ b/src/gui/util/cairo-util.hpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file cairo-util.hpp + ** TODO cairo-util.hpp */ #include diff --git a/src/gui/util/rectangle.cpp b/src/gui/util/rectangle.cpp index e8abc2379..e5b0d4ca6 100644 --- a/src/gui/util/rectangle.cpp +++ b/src/gui/util/rectangle.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file rectangle.cpp + ** TODO rectangle.cpp */ #include "gui/util/rectangle.hpp" diff --git a/src/gui/util/rectangle.hpp b/src/gui/util/rectangle.hpp index fb428ee74..29b0e79e9 100644 --- a/src/gui/util/rectangle.hpp +++ b/src/gui/util/rectangle.hpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file rectangle.hpp + ** TODO rectangle.hpp */ diff --git a/src/gui/widget/button-bar.cpp b/src/gui/widget/button-bar.cpp index 91c15059a..447814917 100644 --- a/src/gui/widget/button-bar.cpp +++ b/src/gui/widget/button-bar.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file button-bar.cpp + ** TODO button-bar.cpp */ diff --git a/src/gui/widget/button-bar.hpp b/src/gui/widget/button-bar.hpp index da33f0601..51ff650ea 100644 --- a/src/gui/widget/button-bar.hpp +++ b/src/gui/widget/button-bar.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file button-bar.hpp + ** TODO button-bar.hpp */ diff --git a/src/gui/widget/menu-button.cpp b/src/gui/widget/menu-button.cpp index f38a85873..9884cf7a7 100644 --- a/src/gui/widget/menu-button.cpp +++ b/src/gui/widget/menu-button.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file menu-button.cpp + ** TODO menu-button.cpp */ diff --git a/src/gui/widget/menu-button.hpp b/src/gui/widget/menu-button.hpp index e43d96b1e..e738c5082 100644 --- a/src/gui/widget/menu-button.hpp +++ b/src/gui/widget/menu-button.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file menu-button.hpp + ** TODO menu-button.hpp */ diff --git a/src/gui/widget/mini-button.hpp b/src/gui/widget/mini-button.hpp index 42bc64150..a7ca68490 100644 --- a/src/gui/widget/mini-button.hpp +++ b/src/gui/widget/mini-button.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file mini-button.hpp + ** TODO mini-button.hpp */ diff --git a/src/gui/widget/panel-bar.cpp b/src/gui/widget/panel-bar.cpp index 6e4a6d311..ed33092c3 100644 --- a/src/gui/widget/panel-bar.cpp +++ b/src/gui/widget/panel-bar.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file panel-bar.cpp + ** TODO panel-bar.cpp */ diff --git a/src/gui/widget/timecode-widget.cpp b/src/gui/widget/timecode-widget.cpp index a2f68c286..7108e11f1 100644 --- a/src/gui/widget/timecode-widget.cpp +++ b/src/gui/widget/timecode-widget.cpp @@ -24,8 +24,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timecode-widget.cpp + ** TODO timecode-widget.cpp */ diff --git a/src/gui/widget/timecode-widget.hpp b/src/gui/widget/timecode-widget.hpp index 920491230..87792dcdf 100644 --- a/src/gui/widget/timecode-widget.hpp +++ b/src/gui/widget/timecode-widget.hpp @@ -24,8 +24,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file timecode-widget.hpp + ** TODO timecode-widget.hpp */ diff --git a/src/gui/widget/timeline-widget.cpp b/src/gui/widget/timeline-widget.cpp index 1513020ad..05ffd7990 100644 --- a/src/gui/widget/timeline-widget.cpp +++ b/src/gui/widget/timeline-widget.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timeline-widget.cpp + ** TODO timeline-widget.cpp */ diff --git a/src/gui/widget/timeline/basic-draw-strategy.hpp b/src/gui/widget/timeline/basic-draw-strategy.hpp index 4be0d36fd..58ef4f185 100644 --- a/src/gui/widget/timeline/basic-draw-strategy.hpp +++ b/src/gui/widget/timeline/basic-draw-strategy.hpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file basic-draw-strategy.hpp + ** TODO basic-draw-strategy.hpp */ diff --git a/src/gui/widget/timeline/draw-strategy.cpp b/src/gui/widget/timeline/draw-strategy.cpp index be6b708a7..8932520d0 100644 --- a/src/gui/widget/timeline/draw-strategy.cpp +++ b/src/gui/widget/timeline/draw-strategy.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file draw-strategy.cpp + ** TODO draw-strategy.cpp */ diff --git a/src/gui/widget/timeline/draw-strategy.hpp b/src/gui/widget/timeline/draw-strategy.hpp index 8520e8ad4..4f1ef7201 100644 --- a/src/gui/widget/timeline/draw-strategy.hpp +++ b/src/gui/widget/timeline/draw-strategy.hpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file draw-strategy.hpp + ** TODO draw-strategy.hpp */ diff --git a/src/gui/widget/timeline/timeline-arrow-tool.cpp b/src/gui/widget/timeline/timeline-arrow-tool.cpp index 65d472be1..b00953bed 100644 --- a/src/gui/widget/timeline/timeline-arrow-tool.cpp +++ b/src/gui/widget/timeline/timeline-arrow-tool.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timeline-arrow-tool.cpp + ** TODO timeline-arrow-tool.cpp */ diff --git a/src/gui/widget/timeline/timeline-body.cpp b/src/gui/widget/timeline/timeline-body.cpp index 8355a5fde..cb5881d72 100644 --- a/src/gui/widget/timeline/timeline-body.cpp +++ b/src/gui/widget/timeline/timeline-body.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timeline-body.cpp + ** TODO timeline-body.cpp */ diff --git a/src/gui/widget/timeline/timeline-clip-track.cpp b/src/gui/widget/timeline/timeline-clip-track.cpp index 1e53747f2..220b0d7f4 100644 --- a/src/gui/widget/timeline/timeline-clip-track.cpp +++ b/src/gui/widget/timeline/timeline-clip-track.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timeline-clip-track.cpp + ** TODO timeline-clip-track.cpp */ diff --git a/src/gui/widget/timeline/timeline-clip.cpp b/src/gui/widget/timeline/timeline-clip.cpp index 23d6ea98b..2d557b4bd 100644 --- a/src/gui/widget/timeline/timeline-clip.cpp +++ b/src/gui/widget/timeline/timeline-clip.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timeline-clip.cpp + ** TODO timeline-clip.cpp */ diff --git a/src/gui/widget/timeline/timeline-entity.cpp b/src/gui/widget/timeline/timeline-entity.cpp index 851cd4be7..73b865746 100644 --- a/src/gui/widget/timeline/timeline-entity.cpp +++ b/src/gui/widget/timeline/timeline-entity.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timeline-entity.cpp + ** TODO timeline-entity.cpp */ diff --git a/src/gui/widget/timeline/timeline-group-track.cpp b/src/gui/widget/timeline/timeline-group-track.cpp index 283fc8fc8..e8534cd69 100644 --- a/src/gui/widget/timeline/timeline-group-track.cpp +++ b/src/gui/widget/timeline/timeline-group-track.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timeline-group-track.cpp + ** TODO timeline-group-track.cpp */ diff --git a/src/gui/widget/timeline/timeline-group-track.hpp b/src/gui/widget/timeline/timeline-group-track.hpp index 4a3821de9..882bdac52 100644 --- a/src/gui/widget/timeline/timeline-group-track.hpp +++ b/src/gui/widget/timeline/timeline-group-track.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file timeline-group-track.hpp + ** TODO timeline-group-track.hpp */ diff --git a/src/gui/widget/timeline/timeline-header-container.cpp b/src/gui/widget/timeline/timeline-header-container.cpp index 56ae2cad9..5818f56d5 100644 --- a/src/gui/widget/timeline/timeline-header-container.cpp +++ b/src/gui/widget/timeline/timeline-header-container.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timeline-header-container.cpp + ** TODO timeline-header-container.cpp */ diff --git a/src/gui/widget/timeline/timeline-header-container.hpp b/src/gui/widget/timeline/timeline-header-container.hpp index 89d5f14a1..60403f4a9 100644 --- a/src/gui/widget/timeline/timeline-header-container.hpp +++ b/src/gui/widget/timeline/timeline-header-container.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file timeline-header-container.hpp + ** TODO timeline-header-container.hpp */ diff --git a/src/gui/widget/timeline/timeline-header-widget.cpp b/src/gui/widget/timeline/timeline-header-widget.cpp index cd388afd9..877184899 100644 --- a/src/gui/widget/timeline/timeline-header-widget.cpp +++ b/src/gui/widget/timeline/timeline-header-widget.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timeline-header-widget.cpp + ** TODO timeline-header-widget.cpp */ diff --git a/src/gui/widget/timeline/timeline-header-widget.hpp b/src/gui/widget/timeline/timeline-header-widget.hpp index e00cca46b..543fce7ca 100644 --- a/src/gui/widget/timeline/timeline-header-widget.hpp +++ b/src/gui/widget/timeline/timeline-header-widget.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file timeline-header-widget.hpp + ** TODO timeline-header-widget.hpp */ diff --git a/src/gui/widget/timeline/timeline-ibeam-tool.cpp b/src/gui/widget/timeline/timeline-ibeam-tool.cpp index cd017a095..1002a5a2b 100644 --- a/src/gui/widget/timeline/timeline-ibeam-tool.cpp +++ b/src/gui/widget/timeline/timeline-ibeam-tool.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timeline-ibeam-tool.cpp + ** TODO timeline-ibeam-tool.cpp */ diff --git a/src/gui/widget/timeline/timeline-layout-helper.cpp b/src/gui/widget/timeline/timeline-layout-helper.cpp index 357765c15..c6628709e 100644 --- a/src/gui/widget/timeline/timeline-layout-helper.cpp +++ b/src/gui/widget/timeline/timeline-layout-helper.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timeline-layout-helper.cpp + ** TODO timeline-layout-helper.cpp */ diff --git a/src/gui/widget/timeline/timeline-ruler.cpp b/src/gui/widget/timeline/timeline-ruler.cpp index 8c527948d..58b88d833 100644 --- a/src/gui/widget/timeline/timeline-ruler.cpp +++ b/src/gui/widget/timeline/timeline-ruler.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timeline-ruler.cpp + ** TODO timeline-ruler.cpp */ diff --git a/src/gui/widget/timeline/timeline-ruler.hpp b/src/gui/widget/timeline/timeline-ruler.hpp index 3783f4bb9..597544772 100644 --- a/src/gui/widget/timeline/timeline-ruler.hpp +++ b/src/gui/widget/timeline/timeline-ruler.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file timeline-ruler.hpp + ** TODO timeline-ruler.hpp */ diff --git a/src/gui/widget/timeline/timeline-state.cpp b/src/gui/widget/timeline/timeline-state.cpp index 955ec69fa..c606b34b2 100644 --- a/src/gui/widget/timeline/timeline-state.cpp +++ b/src/gui/widget/timeline/timeline-state.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timeline-state.cpp + ** TODO timeline-state.cpp */ diff --git a/src/gui/widget/timeline/timeline-state.hpp b/src/gui/widget/timeline/timeline-state.hpp index bea468d3e..8766d344c 100644 --- a/src/gui/widget/timeline/timeline-state.hpp +++ b/src/gui/widget/timeline/timeline-state.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file timeline-state.hpp + ** TODO timeline-state.hpp */ diff --git a/src/gui/widget/timeline/timeline-tool.cpp b/src/gui/widget/timeline/timeline-tool.cpp index 64a6bc68e..03d1baeda 100644 --- a/src/gui/widget/timeline/timeline-tool.cpp +++ b/src/gui/widget/timeline/timeline-tool.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timeline-tool.cpp + ** TODO timeline-tool.cpp */ diff --git a/src/gui/widget/timeline/timeline-tool.hpp b/src/gui/widget/timeline/timeline-tool.hpp index 946d41398..ade34456b 100644 --- a/src/gui/widget/timeline/timeline-tool.hpp +++ b/src/gui/widget/timeline/timeline-tool.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file timeline-tool.hpp + ** TODO timeline-tool.hpp */ diff --git a/src/gui/widget/timeline/timeline-track.cpp b/src/gui/widget/timeline/timeline-track.cpp index a43bc666a..125d9533c 100644 --- a/src/gui/widget/timeline/timeline-track.cpp +++ b/src/gui/widget/timeline/timeline-track.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timeline-track.cpp + ** TODO timeline-track.cpp */ diff --git a/src/gui/widget/timeline/timeline-track.hpp b/src/gui/widget/timeline/timeline-track.hpp index 72b009aab..47757c989 100644 --- a/src/gui/widget/timeline/timeline-track.hpp +++ b/src/gui/widget/timeline/timeline-track.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file timeline-track.hpp + ** TODO timeline-track.hpp */ diff --git a/src/gui/widget/timeline/timeline-view-window.cpp b/src/gui/widget/timeline/timeline-view-window.cpp index be2d6d2f3..beb99bb37 100644 --- a/src/gui/widget/timeline/timeline-view-window.cpp +++ b/src/gui/widget/timeline/timeline-view-window.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timeline-view-window.cpp + ** TODO timeline-view-window.cpp */ diff --git a/src/gui/widget/timeline/timeline-view-window.hpp b/src/gui/widget/timeline/timeline-view-window.hpp index 345e75540..d5641b7db 100644 --- a/src/gui/widget/timeline/timeline-view-window.hpp +++ b/src/gui/widget/timeline/timeline-view-window.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file timeline-view-window.hpp + ** TODO timeline-view-window.hpp */ diff --git a/src/gui/widget/timeline/timeline-zoom-scale.cpp b/src/gui/widget/timeline/timeline-zoom-scale.cpp index 5f9b9bf37..4cdc9252e 100644 --- a/src/gui/widget/timeline/timeline-zoom-scale.cpp +++ b/src/gui/widget/timeline/timeline-zoom-scale.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timeline-zoom-scale.cpp + ** TODO timeline-zoom-scale.cpp */ diff --git a/src/gui/widget/timeline/timeline-zoom-scale.hpp b/src/gui/widget/timeline/timeline-zoom-scale.hpp index 62206a11e..d5bd87270 100644 --- a/src/gui/widget/timeline/timeline-zoom-scale.hpp +++ b/src/gui/widget/timeline/timeline-zoom-scale.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file timeline-zoom-scale.hpp + ** TODO timeline-zoom-scale.hpp */ diff --git a/src/gui/widget/video-display-widget.cpp b/src/gui/widget/video-display-widget.cpp index 7cf603e8b..94251b9b0 100644 --- a/src/gui/widget/video-display-widget.cpp +++ b/src/gui/widget/video-display-widget.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file video-display-widget.cpp + ** TODO video-display-widget.cpp */ diff --git a/src/gui/widget/video-display-widget.hpp b/src/gui/widget/video-display-widget.hpp index aaca812e0..060db075f 100644 --- a/src/gui/widget/video-display-widget.hpp +++ b/src/gui/widget/video-display-widget.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file video-display-widget.hpp + ** TODO video-display-widget.hpp */ diff --git a/src/gui/window-manager.cpp b/src/gui/window-manager.cpp index 9d5bfd4be..28fd61708 100644 --- a/src/gui/window-manager.cpp +++ b/src/gui/window-manager.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file window-manager.cpp + ** TODO window-manager.cpp */ diff --git a/src/gui/workspace/actions.cpp b/src/gui/workspace/actions.cpp index 267e8795e..ddbecf1ef 100644 --- a/src/gui/workspace/actions.cpp +++ b/src/gui/workspace/actions.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file actions.cpp + ** TODO actions.cpp */ diff --git a/src/gui/workspace/panel-manager.cpp b/src/gui/workspace/panel-manager.cpp index 5930c6984..1e48b6057 100644 --- a/src/gui/workspace/panel-manager.cpp +++ b/src/gui/workspace/panel-manager.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file panel-manager.cpp + ** TODO panel-manager.cpp */ diff --git a/src/gui/workspace/workspace-window.cpp b/src/gui/workspace/workspace-window.cpp index 1301bd88c..a9ece083e 100644 --- a/src/gui/workspace/workspace-window.cpp +++ b/src/gui/workspace/workspace-window.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file workspace-window.cpp + ** TODO workspace-window.cpp */ #include "gui/gtk-lumiera.hpp" diff --git a/src/lib/allocation-cluster.cpp b/src/lib/allocation-cluster.cpp index 4abc2992d..c7bfcacb2 100644 --- a/src/lib/allocation-cluster.cpp +++ b/src/lib/allocation-cluster.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file allocation-cluster.cpp + ** TODO allocation-cluster.cpp */ diff --git a/src/lib/bool-checkable.hpp b/src/lib/bool-checkable.hpp index 1f7203028..e0bb770ea 100644 --- a/src/lib/bool-checkable.hpp +++ b/src/lib/bool-checkable.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file bool-checkable.hpp + ** TODO bool-checkable.hpp */ diff --git a/src/lib/cmdline.cpp b/src/lib/cmdline.cpp index fe9973de0..38b08dcf5 100644 --- a/src/lib/cmdline.cpp +++ b/src/lib/cmdline.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file cmdline.cpp + ** TODO cmdline.cpp */ diff --git a/src/lib/cmdline.hpp b/src/lib/cmdline.hpp index e998f96e5..cbd61a807 100644 --- a/src/lib/cmdline.hpp +++ b/src/lib/cmdline.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file cmdline.hpp + ** TODO cmdline.hpp */ diff --git a/src/lib/dependency-factory.hpp b/src/lib/dependency-factory.hpp index 8de45a237..18b204775 100644 --- a/src/lib/dependency-factory.hpp +++ b/src/lib/dependency-factory.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file dependency-factory.hpp + ** TODO dependency-factory.hpp */ diff --git a/src/lib/frameid.hpp b/src/lib/frameid.hpp index 202d0ff3d..4f2870d8a 100644 --- a/src/lib/frameid.hpp +++ b/src/lib/frameid.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file frameid.hpp + ** TODO frameid.hpp */ diff --git a/src/lib/idi/genfunc.cpp b/src/lib/idi/genfunc.cpp index 69fa9496f..9e4bce312 100644 --- a/src/lib/idi/genfunc.cpp +++ b/src/lib/idi/genfunc.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file genfunc.cpp + ** TODO genfunc.cpp */ diff --git a/src/lib/lifecycle.cpp b/src/lib/lifecycle.cpp index 133d22e17..de73c02df 100644 --- a/src/lib/lifecycle.cpp +++ b/src/lib/lifecycle.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file lifecycle.cpp + ** TODO lifecycle.cpp */ diff --git a/src/lib/meta/maybe-compare.hpp b/src/lib/meta/maybe-compare.hpp index bf5ae828d..ef1d14b49 100644 --- a/src/lib/meta/maybe-compare.hpp +++ b/src/lib/meta/maybe-compare.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file maybe-compare.hpp + ** TODO maybe-compare.hpp */ diff --git a/src/lib/meta/no-instance.hpp b/src/lib/meta/no-instance.hpp index d3f7ca4d0..5290bf480 100644 --- a/src/lib/meta/no-instance.hpp +++ b/src/lib/meta/no-instance.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file no-instance.hpp + ** TODO no-instance.hpp */ diff --git a/src/lib/meta/size-trait.hpp b/src/lib/meta/size-trait.hpp index 21578a7c6..10cd0b831 100644 --- a/src/lib/meta/size-trait.hpp +++ b/src/lib/meta/size-trait.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file size-trait.hpp + ** TODO size-trait.hpp */ diff --git a/src/lib/meta/trait-special.hpp b/src/lib/meta/trait-special.hpp index 694bd4191..4be352e30 100644 --- a/src/lib/meta/trait-special.hpp +++ b/src/lib/meta/trait-special.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file trait-special.hpp + ** TODO trait-special.hpp */ diff --git a/src/lib/nobug-init.cpp b/src/lib/nobug-init.cpp index c483310ad..ca13baad0 100644 --- a/src/lib/nobug-init.cpp +++ b/src/lib/nobug-init.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file nobug-init.cpp + ** TODO nobug-init.cpp */ diff --git a/src/lib/nocopy.hpp b/src/lib/nocopy.hpp index b07b72a03..6fd3db8a7 100644 --- a/src/lib/nocopy.hpp +++ b/src/lib/nocopy.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file nocopy.hpp + ** TODO nocopy.hpp */ diff --git a/src/lib/optional-ref.hpp b/src/lib/optional-ref.hpp index be0caabed..4baad2112 100644 --- a/src/lib/optional-ref.hpp +++ b/src/lib/optional-ref.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file optional-ref.hpp + ** TODO optional-ref.hpp */ diff --git a/src/lib/query-diagnostics.hpp b/src/lib/query-diagnostics.hpp index 5c28a1077..5bae2f35a 100644 --- a/src/lib/query-diagnostics.hpp +++ b/src/lib/query-diagnostics.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file query-diagnostics.hpp + ** TODO query-diagnostics.hpp */ diff --git a/src/lib/query-text.cpp b/src/lib/query-text.cpp index a2857387e..d09ba8bb9 100644 --- a/src/lib/query-text.cpp +++ b/src/lib/query-text.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file query-text.cpp + ** TODO query-text.cpp */ diff --git a/src/lib/query-util.cpp b/src/lib/query-util.cpp index 6e101f073..d91c99d89 100644 --- a/src/lib/query-util.cpp +++ b/src/lib/query-util.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file query-util.cpp + ** TODO query-util.cpp */ diff --git a/src/lib/query-util.hpp b/src/lib/query-util.hpp index 0f90a56e1..f604d3904 100644 --- a/src/lib/query-util.hpp +++ b/src/lib/query-util.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file query-util.hpp + ** TODO query-util.hpp */ diff --git a/src/lib/ref-array.hpp b/src/lib/ref-array.hpp index 4401687fa..7f79fb40f 100644 --- a/src/lib/ref-array.hpp +++ b/src/lib/ref-array.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file ref-array.hpp + ** TODO ref-array.hpp */ diff --git a/src/lib/scoped-holder-transfer.hpp b/src/lib/scoped-holder-transfer.hpp index 17d47bda8..a8b36401d 100644 --- a/src/lib/scoped-holder-transfer.hpp +++ b/src/lib/scoped-holder-transfer.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file scoped-holder-transfer.hpp + ** TODO scoped-holder-transfer.hpp */ diff --git a/src/lib/searchpath.cpp b/src/lib/searchpath.cpp index 4ceaed302..2f67f6e7e 100644 --- a/src/lib/searchpath.cpp +++ b/src/lib/searchpath.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file searchpath.cpp + ** TODO searchpath.cpp */ diff --git a/src/lib/searchpath.hpp b/src/lib/searchpath.hpp index e9d66b8e8..3de3c6c92 100644 --- a/src/lib/searchpath.hpp +++ b/src/lib/searchpath.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file searchpath.hpp + ** TODO searchpath.hpp */ diff --git a/src/lib/test/depend-4test.hpp b/src/lib/test/depend-4test.hpp index e113cd74e..141ba54a6 100644 --- a/src/lib/test/depend-4test.hpp +++ b/src/lib/test/depend-4test.hpp @@ -22,8 +22,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file depend-4test.hpp + ** TODO depend-4test.hpp */ diff --git a/src/lib/test/event-log.cpp b/src/lib/test/event-log.cpp index bd9699cae..4bf1a3abb 100644 --- a/src/lib/test/event-log.cpp +++ b/src/lib/test/event-log.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file event-log.cpp + ** TODO event-log.cpp */ diff --git a/src/lib/test/suite.cpp b/src/lib/test/suite.cpp index 22595a2ca..a28665831 100644 --- a/src/lib/test/suite.cpp +++ b/src/lib/test/suite.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file suite.cpp + ** TODO suite.cpp */ diff --git a/src/lib/test/test-coll.hpp b/src/lib/test/test-coll.hpp index c9fc3974e..e6fe7652c 100644 --- a/src/lib/test/test-coll.hpp +++ b/src/lib/test/test-coll.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file test-coll.hpp + ** TODO test-coll.hpp */ diff --git a/src/lib/test/testdummy.hpp b/src/lib/test/testdummy.hpp index e3924fcf5..4a9e91b7e 100644 --- a/src/lib/test/testdummy.hpp +++ b/src/lib/test/testdummy.hpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file testdummy.hpp + ** TODO testdummy.hpp */ diff --git a/src/lib/test/testoption.cpp b/src/lib/test/testoption.cpp index baff50496..c5b492500 100644 --- a/src/lib/test/testoption.cpp +++ b/src/lib/test/testoption.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file testoption.cpp + ** TODO testoption.cpp */ diff --git a/src/lib/test/testoption.hpp b/src/lib/test/testoption.hpp index 173d96ef5..fc99558fc 100644 --- a/src/lib/test/testoption.hpp +++ b/src/lib/test/testoption.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file testoption.hpp + ** TODO testoption.hpp */ diff --git a/src/lib/time/formats.hpp b/src/lib/time/formats.hpp index d0209f105..a3643963e 100644 --- a/src/lib/time/formats.hpp +++ b/src/lib/time/formats.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file formats.hpp + ** TODO formats.hpp */ diff --git a/src/lib/time/grid.hpp b/src/lib/time/grid.hpp index 87013c8ed..70a924669 100644 --- a/src/lib/time/grid.hpp +++ b/src/lib/time/grid.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file grid.hpp + ** TODO grid.hpp */ diff --git a/src/lib/time/quantiser.cpp b/src/lib/time/quantiser.cpp index 31382750b..6f242ecb5 100644 --- a/src/lib/time/quantiser.cpp +++ b/src/lib/time/quantiser.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file quantiser.cpp + ** TODO quantiser.cpp */ diff --git a/src/lib/time/quantiser.hpp b/src/lib/time/quantiser.hpp index 2cca06f50..24cbaeac3 100644 --- a/src/lib/time/quantiser.hpp +++ b/src/lib/time/quantiser.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file quantiser.hpp + ** TODO quantiser.hpp */ diff --git a/src/lib/time/timecode.cpp b/src/lib/time/timecode.cpp index 2012d0e9d..5e5e6b0ec 100644 --- a/src/lib/time/timecode.cpp +++ b/src/lib/time/timecode.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timecode.cpp + ** TODO timecode.cpp */ diff --git a/src/lib/time/timecode.hpp b/src/lib/time/timecode.hpp index d17b38811..203bacd13 100644 --- a/src/lib/time/timecode.hpp +++ b/src/lib/time/timecode.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file timecode.hpp + ** TODO timecode.hpp */ diff --git a/src/lib/time/timequant.hpp b/src/lib/time/timequant.hpp index 1ce80e269..b029efd04 100644 --- a/src/lib/time/timequant.hpp +++ b/src/lib/time/timequant.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file timequant.hpp + ** TODO timequant.hpp */ diff --git a/src/lib/util-quant.hpp b/src/lib/util-quant.hpp index 466733eb8..c0d4bd30b 100644 --- a/src/lib/util-quant.hpp +++ b/src/lib/util-quant.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file util-quant.hpp + ** TODO util-quant.hpp */ diff --git a/src/lib/util.cpp b/src/lib/util.cpp index b55d124b0..0eeb3c174 100644 --- a/src/lib/util.cpp +++ b/src/lib/util.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file util.cpp + ** TODO util.cpp */ diff --git a/src/lib/util.hpp b/src/lib/util.hpp index cb75db01e..4e00fc7ae 100644 --- a/src/lib/util.hpp +++ b/src/lib/util.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file util.hpp + ** TODO util.hpp */ diff --git a/src/lib/visitor-dispatcher.hpp b/src/lib/visitor-dispatcher.hpp index 3cf95dcc7..60dbc78e5 100644 --- a/src/lib/visitor-dispatcher.hpp +++ b/src/lib/visitor-dispatcher.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file visitor-dispatcher.hpp + ** TODO visitor-dispatcher.hpp */ diff --git a/src/lib/wrapperptr.hpp b/src/lib/wrapperptr.hpp index ba4b09318..5fb91a003 100644 --- a/src/lib/wrapperptr.hpp +++ b/src/lib/wrapperptr.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file wrapperptr.hpp + ** TODO wrapperptr.hpp */ diff --git a/src/lumiera/main.cpp b/src/lumiera/main.cpp index 3d2ecd38f..d74359cbd 100644 --- a/src/lumiera/main.cpp +++ b/src/lumiera/main.cpp @@ -22,8 +22,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file main.cpp + ** TODO main.cpp */ diff --git a/src/proc/asset.cpp b/src/proc/asset.cpp index 727f9e576..6ae12a6b1 100644 --- a/src/proc/asset.cpp +++ b/src/proc/asset.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file asset.cpp + ** TODO asset.cpp */ diff --git a/src/proc/asset/category.cpp b/src/proc/asset/category.cpp index 352814d64..b1404387f 100644 --- a/src/proc/asset/category.cpp +++ b/src/proc/asset/category.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file category.cpp + ** TODO category.cpp */ diff --git a/src/proc/asset/category.hpp b/src/proc/asset/category.hpp index b3da246ab..51d96f8f1 100644 --- a/src/proc/asset/category.hpp +++ b/src/proc/asset/category.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file category.hpp + ** TODO category.hpp */ diff --git a/src/proc/asset/clip.cpp b/src/proc/asset/clip.cpp index 0cb99de13..fbf634364 100644 --- a/src/proc/asset/clip.cpp +++ b/src/proc/asset/clip.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file clip.cpp + ** TODO clip.cpp */ diff --git a/src/proc/asset/clip.hpp b/src/proc/asset/clip.hpp index 27c02783a..cb3f4a766 100644 --- a/src/proc/asset/clip.hpp +++ b/src/proc/asset/clip.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file clip.hpp + ** TODO clip.hpp */ diff --git a/src/proc/asset/codec.cpp b/src/proc/asset/codec.cpp index afd723c25..3c4571c2e 100644 --- a/src/proc/asset/codec.cpp +++ b/src/proc/asset/codec.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file codec.cpp + ** TODO codec.cpp */ diff --git a/src/proc/asset/codec.hpp b/src/proc/asset/codec.hpp index 82cb9151e..c72e72063 100644 --- a/src/proc/asset/codec.hpp +++ b/src/proc/asset/codec.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file codec.hpp + ** TODO codec.hpp */ diff --git a/src/proc/asset/compoundmedia.cpp b/src/proc/asset/compoundmedia.cpp index 0c3256205..402758f41 100644 --- a/src/proc/asset/compoundmedia.cpp +++ b/src/proc/asset/compoundmedia.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file compoundmedia.cpp + ** TODO compoundmedia.cpp */ diff --git a/src/proc/asset/compoundmedia.hpp b/src/proc/asset/compoundmedia.hpp index bed3e60aa..5c5a3e069 100644 --- a/src/proc/asset/compoundmedia.hpp +++ b/src/proc/asset/compoundmedia.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file compoundmedia.hpp + ** TODO compoundmedia.hpp */ diff --git a/src/proc/asset/dataset.hpp b/src/proc/asset/dataset.hpp index 8f030eec9..3b414dd6e 100644 --- a/src/proc/asset/dataset.hpp +++ b/src/proc/asset/dataset.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file dataset.hpp + ** TODO dataset.hpp */ diff --git a/src/proc/asset/db.hpp b/src/proc/asset/db.hpp index ec116e5a6..562a42cb8 100644 --- a/src/proc/asset/db.hpp +++ b/src/proc/asset/db.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file db.hpp + ** TODO db.hpp */ diff --git a/src/proc/asset/effect.cpp b/src/proc/asset/effect.cpp index ebefd30c3..de3a16b62 100644 --- a/src/proc/asset/effect.cpp +++ b/src/proc/asset/effect.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file effect.cpp + ** TODO effect.cpp */ diff --git a/src/proc/asset/effect.hpp b/src/proc/asset/effect.hpp index 94adfea21..2a4658f79 100644 --- a/src/proc/asset/effect.hpp +++ b/src/proc/asset/effect.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file effect.hpp + ** TODO effect.hpp */ diff --git a/src/proc/asset/inventory.hpp b/src/proc/asset/inventory.hpp index 35944f934..1b70cd032 100644 --- a/src/proc/asset/inventory.hpp +++ b/src/proc/asset/inventory.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file inventory.hpp + ** TODO inventory.hpp */ diff --git a/src/proc/asset/media.cpp b/src/proc/asset/media.cpp index cacee9c1d..13fb4bf6d 100644 --- a/src/proc/asset/media.cpp +++ b/src/proc/asset/media.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file media.cpp + ** TODO media.cpp */ diff --git a/src/proc/asset/meta.cpp b/src/proc/asset/meta.cpp index f9ccdea7e..9f7ade718 100644 --- a/src/proc/asset/meta.cpp +++ b/src/proc/asset/meta.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file meta.cpp + ** TODO meta.cpp */ diff --git a/src/proc/asset/meta/time-grid.cpp b/src/proc/asset/meta/time-grid.cpp index c79e74ed3..153020ede 100644 --- a/src/proc/asset/meta/time-grid.cpp +++ b/src/proc/asset/meta/time-grid.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file time-grid.cpp + ** TODO time-grid.cpp */ diff --git a/src/proc/asset/pipe.cpp b/src/proc/asset/pipe.cpp index 340a104f8..92efc3163 100644 --- a/src/proc/asset/pipe.cpp +++ b/src/proc/asset/pipe.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file pipe.cpp + ** TODO pipe.cpp */ diff --git a/src/proc/asset/pipe.hpp b/src/proc/asset/pipe.hpp index f848cf77b..dd473b21d 100644 --- a/src/proc/asset/pipe.hpp +++ b/src/proc/asset/pipe.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file pipe.hpp + ** TODO pipe.hpp */ diff --git a/src/proc/asset/preview.cpp b/src/proc/asset/preview.cpp index dbab270c0..9f8c42e11 100644 --- a/src/proc/asset/preview.cpp +++ b/src/proc/asset/preview.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file preview.cpp + ** TODO preview.cpp */ diff --git a/src/proc/asset/preview.hpp b/src/proc/asset/preview.hpp index 7a1428d61..5abf53f3b 100644 --- a/src/proc/asset/preview.hpp +++ b/src/proc/asset/preview.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file preview.hpp + ** TODO preview.hpp */ diff --git a/src/proc/asset/proc.cpp b/src/proc/asset/proc.cpp index 2045aac5e..125ac7023 100644 --- a/src/proc/asset/proc.cpp +++ b/src/proc/asset/proc.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file proc.cpp + ** TODO proc.cpp */ diff --git a/src/proc/asset/procpatt.cpp b/src/proc/asset/procpatt.cpp index c2bc0411f..a53a32335 100644 --- a/src/proc/asset/procpatt.cpp +++ b/src/proc/asset/procpatt.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file procpatt.cpp + ** TODO procpatt.cpp */ diff --git a/src/proc/asset/procpatt.hpp b/src/proc/asset/procpatt.hpp index 23fe451d6..1528222d6 100644 --- a/src/proc/asset/procpatt.hpp +++ b/src/proc/asset/procpatt.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file procpatt.hpp + ** TODO procpatt.hpp */ diff --git a/src/proc/asset/sequence.cpp b/src/proc/asset/sequence.cpp index 917370a04..928535af2 100644 --- a/src/proc/asset/sequence.cpp +++ b/src/proc/asset/sequence.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file sequence.cpp + ** TODO sequence.cpp */ diff --git a/src/proc/asset/struct.cpp b/src/proc/asset/struct.cpp index 00c9fe689..15d9388fb 100644 --- a/src/proc/asset/struct.cpp +++ b/src/proc/asset/struct.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file struct.cpp + ** TODO struct.cpp */ diff --git a/src/proc/asset/timeline.cpp b/src/proc/asset/timeline.cpp index 5f80a05e4..5eb464633 100644 --- a/src/proc/asset/timeline.cpp +++ b/src/proc/asset/timeline.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timeline.cpp + ** TODO timeline.cpp */ diff --git a/src/proc/asset/typed-lookup.cpp b/src/proc/asset/typed-lookup.cpp index bad753148..722fe6bf3 100644 --- a/src/proc/asset/typed-lookup.cpp +++ b/src/proc/asset/typed-lookup.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file typed-lookup.cpp + ** TODO typed-lookup.cpp */ diff --git a/src/proc/asset/unknown.cpp b/src/proc/asset/unknown.cpp index f8559c63f..750ae0845 100644 --- a/src/proc/asset/unknown.cpp +++ b/src/proc/asset/unknown.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file unknown.cpp + ** TODO unknown.cpp */ diff --git a/src/proc/asset/unknown.hpp b/src/proc/asset/unknown.hpp index d025cb7ed..fc89a5582 100644 --- a/src/proc/asset/unknown.hpp +++ b/src/proc/asset/unknown.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file unknown.hpp + ** TODO unknown.hpp */ diff --git a/src/proc/asset/viewer.cpp b/src/proc/asset/viewer.cpp index 3bb9fc81c..d99fe1386 100644 --- a/src/proc/asset/viewer.cpp +++ b/src/proc/asset/viewer.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file viewer.cpp + ** TODO viewer.cpp */ diff --git a/src/proc/assetmanager.cpp b/src/proc/assetmanager.cpp index b0bc5ce83..eeb6ad96a 100644 --- a/src/proc/assetmanager.cpp +++ b/src/proc/assetmanager.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file assetmanager.cpp + ** TODO assetmanager.cpp */ diff --git a/src/proc/config-resolver.cpp b/src/proc/config-resolver.cpp index 971b3d437..5c12ae966 100644 --- a/src/proc/config-resolver.cpp +++ b/src/proc/config-resolver.cpp @@ -22,8 +22,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file config-resolver.cpp + ** TODO config-resolver.cpp */ diff --git a/src/proc/control/argument-erasure.hpp b/src/proc/control/argument-erasure.hpp index 1a6431934..69928a0dc 100644 --- a/src/proc/control/argument-erasure.hpp +++ b/src/proc/control/argument-erasure.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file argument-erasure.hpp + ** TODO argument-erasure.hpp */ diff --git a/src/proc/control/handling-pattern.cpp b/src/proc/control/handling-pattern.cpp index 4d2e02f8d..6d61c0cb0 100644 --- a/src/proc/control/handling-pattern.cpp +++ b/src/proc/control/handling-pattern.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file handling-pattern.cpp + ** TODO handling-pattern.cpp */ diff --git a/src/proc/control/mediaimpllib.hpp b/src/proc/control/mediaimpllib.hpp index 39a44827a..ed4fb7dc2 100644 --- a/src/proc/control/mediaimpllib.hpp +++ b/src/proc/control/mediaimpllib.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file mediaimpllib.hpp + ** TODO mediaimpllib.hpp */ diff --git a/src/proc/control/pathmanager.cpp b/src/proc/control/pathmanager.cpp index 1115745e1..5043a6428 100644 --- a/src/proc/control/pathmanager.cpp +++ b/src/proc/control/pathmanager.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file pathmanager.cpp + ** TODO pathmanager.cpp */ diff --git a/src/proc/control/pathmanager.hpp b/src/proc/control/pathmanager.hpp index 3e320296c..b2a612dea 100644 --- a/src/proc/control/pathmanager.hpp +++ b/src/proc/control/pathmanager.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file pathmanager.hpp + ** TODO pathmanager.hpp */ diff --git a/src/proc/control/proc-dispatcher.cpp b/src/proc/control/proc-dispatcher.cpp index 5190222ce..9e7acd9a1 100644 --- a/src/proc/control/proc-dispatcher.cpp +++ b/src/proc/control/proc-dispatcher.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file proc-dispatcher.cpp + ** TODO proc-dispatcher.cpp */ diff --git a/src/proc/control/stypemanager.cpp b/src/proc/control/stypemanager.cpp index 8b080af5e..cfb5740bc 100644 --- a/src/proc/control/stypemanager.cpp +++ b/src/proc/control/stypemanager.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file stypemanager.cpp + ** TODO stypemanager.cpp */ diff --git a/src/proc/control/stypemanager.hpp b/src/proc/control/stypemanager.hpp index 1557e8b3b..70261638f 100644 --- a/src/proc/control/stypemanager.hpp +++ b/src/proc/control/stypemanager.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file stypemanager.hpp + ** TODO stypemanager.hpp */ diff --git a/src/proc/controllerfacade.cpp b/src/proc/controllerfacade.cpp index 911b77c6f..2cd9d36e8 100644 --- a/src/proc/controllerfacade.cpp +++ b/src/proc/controllerfacade.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file controllerfacade.cpp + ** TODO controllerfacade.cpp */ diff --git a/src/proc/controllerfacade.hpp b/src/proc/controllerfacade.hpp index f8e2819ac..19524433d 100644 --- a/src/proc/controllerfacade.hpp +++ b/src/proc/controllerfacade.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file controllerfacade.hpp + ** TODO controllerfacade.hpp */ diff --git a/src/proc/engine/buffer-local-key.hpp b/src/proc/engine/buffer-local-key.hpp index 7b4c8d063..525ef85ab 100644 --- a/src/proc/engine/buffer-local-key.hpp +++ b/src/proc/engine/buffer-local-key.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file buffer-local-key.hpp + ** TODO buffer-local-key.hpp */ diff --git a/src/proc/engine/buffer-provider.cpp b/src/proc/engine/buffer-provider.cpp index 8727cdcab..5d5ed11ed 100644 --- a/src/proc/engine/buffer-provider.cpp +++ b/src/proc/engine/buffer-provider.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file buffer-provider.cpp + ** TODO buffer-provider.cpp */ diff --git a/src/proc/engine/bufftable-obsolete.hpp b/src/proc/engine/bufftable-obsolete.hpp index f484e0f33..55bcf125c 100644 --- a/src/proc/engine/bufftable-obsolete.hpp +++ b/src/proc/engine/bufftable-obsolete.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file bufftable-obsolete.hpp + ** TODO bufftable-obsolete.hpp */ diff --git a/src/proc/engine/bufftable.hpp b/src/proc/engine/bufftable.hpp index 4de5d0ce8..7942f7ea6 100644 --- a/src/proc/engine/bufftable.hpp +++ b/src/proc/engine/bufftable.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file bufftable.hpp + ** TODO bufftable.hpp */ diff --git a/src/proc/engine/calc-plan-continuation.cpp b/src/proc/engine/calc-plan-continuation.cpp index dc07e0bc1..1ad885f0e 100644 --- a/src/proc/engine/calc-plan-continuation.cpp +++ b/src/proc/engine/calc-plan-continuation.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file calc-plan-continuation.cpp + ** TODO calc-plan-continuation.cpp */ diff --git a/src/proc/engine/calc-plan-continuation.hpp b/src/proc/engine/calc-plan-continuation.hpp index e8e4bd104..772227e81 100644 --- a/src/proc/engine/calc-plan-continuation.hpp +++ b/src/proc/engine/calc-plan-continuation.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file calc-plan-continuation.hpp + ** TODO calc-plan-continuation.hpp */ diff --git a/src/proc/engine/calc-stream.hpp b/src/proc/engine/calc-stream.hpp index 57125399a..f4ab86958 100644 --- a/src/proc/engine/calc-stream.hpp +++ b/src/proc/engine/calc-stream.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file calc-stream.hpp + ** TODO calc-stream.hpp */ diff --git a/src/proc/engine/diagnostic-buffer-provider.cpp b/src/proc/engine/diagnostic-buffer-provider.cpp index 1fbd10b37..10206930d 100644 --- a/src/proc/engine/diagnostic-buffer-provider.cpp +++ b/src/proc/engine/diagnostic-buffer-provider.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file diagnostic-buffer-provider.cpp + ** TODO diagnostic-buffer-provider.cpp */ diff --git a/src/proc/engine/dispatch-table.cpp b/src/proc/engine/dispatch-table.cpp index 8eca0c8ff..45e285e86 100644 --- a/src/proc/engine/dispatch-table.cpp +++ b/src/proc/engine/dispatch-table.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file dispatch-table.cpp + ** TODO dispatch-table.cpp */ diff --git a/src/proc/engine/dispatch-table.hpp b/src/proc/engine/dispatch-table.hpp index 8599f4e67..ea77b3dd1 100644 --- a/src/proc/engine/dispatch-table.hpp +++ b/src/proc/engine/dispatch-table.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file dispatch-table.hpp + ** TODO dispatch-table.hpp */ diff --git a/src/proc/engine/dispatcher.cpp b/src/proc/engine/dispatcher.cpp index 4cc9c3699..1faa3b263 100644 --- a/src/proc/engine/dispatcher.cpp +++ b/src/proc/engine/dispatcher.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file dispatcher.cpp + ** TODO dispatcher.cpp */ diff --git a/src/proc/engine/dispatcher.hpp b/src/proc/engine/dispatcher.hpp index b409e08da..19fd1cacf 100644 --- a/src/proc/engine/dispatcher.hpp +++ b/src/proc/engine/dispatcher.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file dispatcher.hpp + ** TODO dispatcher.hpp */ diff --git a/src/proc/engine/engine-service-mock.cpp b/src/proc/engine/engine-service-mock.cpp index c6dfef556..d1eb8b723 100644 --- a/src/proc/engine/engine-service-mock.cpp +++ b/src/proc/engine/engine-service-mock.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file engine-service-mock.cpp + ** TODO engine-service-mock.cpp */ diff --git a/src/proc/engine/engine-service.cpp b/src/proc/engine/engine-service.cpp index 15244308b..78d470a24 100644 --- a/src/proc/engine/engine-service.cpp +++ b/src/proc/engine/engine-service.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file engine-service.cpp + ** TODO engine-service.cpp */ diff --git a/src/proc/engine/frame-coord.hpp b/src/proc/engine/frame-coord.hpp index 373b611a5..75302d2ef 100644 --- a/src/proc/engine/frame-coord.hpp +++ b/src/proc/engine/frame-coord.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file frame-coord.hpp + ** TODO frame-coord.hpp */ diff --git a/src/proc/engine/job-ticket.hpp b/src/proc/engine/job-ticket.hpp index 468e2a093..8a0c79b23 100644 --- a/src/proc/engine/job-ticket.hpp +++ b/src/proc/engine/job-ticket.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file job-ticket.hpp + ** TODO job-ticket.hpp */ diff --git a/src/proc/engine/link.cpp b/src/proc/engine/link.cpp index 7f5f855c5..3e5a1f3ff 100644 --- a/src/proc/engine/link.cpp +++ b/src/proc/engine/link.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file link.cpp + ** TODO link.cpp */ diff --git a/src/proc/engine/link.hpp b/src/proc/engine/link.hpp index 7d769f1d4..492796564 100644 --- a/src/proc/engine/link.hpp +++ b/src/proc/engine/link.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file link.hpp + ** TODO link.hpp */ diff --git a/src/proc/engine/mask.cpp b/src/proc/engine/mask.cpp index 69a132844..46ef510e8 100644 --- a/src/proc/engine/mask.cpp +++ b/src/proc/engine/mask.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file mask.cpp + ** TODO mask.cpp */ diff --git a/src/proc/engine/mask.hpp b/src/proc/engine/mask.hpp index dddc57a09..46e52202d 100644 --- a/src/proc/engine/mask.hpp +++ b/src/proc/engine/mask.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file mask.hpp + ** TODO mask.hpp */ diff --git a/src/proc/engine/nodefactory.cpp b/src/proc/engine/nodefactory.cpp index ef03b5cea..2b38e4603 100644 --- a/src/proc/engine/nodefactory.cpp +++ b/src/proc/engine/nodefactory.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file nodefactory.cpp + ** TODO nodefactory.cpp */ diff --git a/src/proc/engine/nodefactory.hpp b/src/proc/engine/nodefactory.hpp index 667e3a85c..cfcef40a7 100644 --- a/src/proc/engine/nodefactory.hpp +++ b/src/proc/engine/nodefactory.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file nodefactory.hpp + ** TODO nodefactory.hpp */ diff --git a/src/proc/engine/nodewiring.cpp b/src/proc/engine/nodewiring.cpp index 5267aa932..bcbf10356 100644 --- a/src/proc/engine/nodewiring.cpp +++ b/src/proc/engine/nodewiring.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file nodewiring.cpp + ** TODO nodewiring.cpp */ diff --git a/src/proc/engine/nodewiring.hpp b/src/proc/engine/nodewiring.hpp index a8e8ad4ce..52f073065 100644 --- a/src/proc/engine/nodewiring.hpp +++ b/src/proc/engine/nodewiring.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file nodewiring.hpp + ** TODO nodewiring.hpp */ diff --git a/src/proc/engine/pluginadapter.cpp b/src/proc/engine/pluginadapter.cpp index 696e5d6c3..a71a075fc 100644 --- a/src/proc/engine/pluginadapter.cpp +++ b/src/proc/engine/pluginadapter.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file pluginadapter.cpp + ** TODO pluginadapter.cpp */ diff --git a/src/proc/engine/pluginadapter.hpp b/src/proc/engine/pluginadapter.hpp index 49bee21f5..cd3b6e348 100644 --- a/src/proc/engine/pluginadapter.hpp +++ b/src/proc/engine/pluginadapter.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file pluginadapter.hpp + ** TODO pluginadapter.hpp */ diff --git a/src/proc/engine/render-invocation.cpp b/src/proc/engine/render-invocation.cpp index 922507e13..7930b0da0 100644 --- a/src/proc/engine/render-invocation.cpp +++ b/src/proc/engine/render-invocation.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file render-invocation.cpp + ** TODO render-invocation.cpp */ diff --git a/src/proc/engine/renderengine.cpp b/src/proc/engine/renderengine.cpp index b786e8cb8..13867c77e 100644 --- a/src/proc/engine/renderengine.cpp +++ b/src/proc/engine/renderengine.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file renderengine.cpp + ** TODO renderengine.cpp */ diff --git a/src/proc/engine/renderengine.hpp b/src/proc/engine/renderengine.hpp index b743af9f9..e3d30e480 100644 --- a/src/proc/engine/renderengine.hpp +++ b/src/proc/engine/renderengine.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file renderengine.hpp + ** TODO renderengine.hpp */ diff --git a/src/proc/engine/rendergraph.cpp b/src/proc/engine/rendergraph.cpp index 83cd52170..a5ec10120 100644 --- a/src/proc/engine/rendergraph.cpp +++ b/src/proc/engine/rendergraph.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file rendergraph.cpp + ** TODO rendergraph.cpp */ diff --git a/src/proc/engine/rendergraph.hpp b/src/proc/engine/rendergraph.hpp index f2a29114c..69ff271d4 100644 --- a/src/proc/engine/rendergraph.hpp +++ b/src/proc/engine/rendergraph.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file rendergraph.hpp + ** TODO rendergraph.hpp */ diff --git a/src/proc/engine/source.cpp b/src/proc/engine/source.cpp index 30f6f38a3..d4f597609 100644 --- a/src/proc/engine/source.cpp +++ b/src/proc/engine/source.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file source.cpp + ** TODO source.cpp */ diff --git a/src/proc/engine/source.hpp b/src/proc/engine/source.hpp index 5b10fc1f6..9fbe24721 100644 --- a/src/proc/engine/source.hpp +++ b/src/proc/engine/source.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file source.hpp + ** TODO source.hpp */ diff --git a/src/proc/engine/stateproxy.cpp b/src/proc/engine/stateproxy.cpp index 438553beb..2c265ec4c 100644 --- a/src/proc/engine/stateproxy.cpp +++ b/src/proc/engine/stateproxy.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file stateproxy.cpp + ** TODO stateproxy.cpp */ diff --git a/src/proc/engine/stateproxy.hpp b/src/proc/engine/stateproxy.hpp index 19bacd5c6..7a623100b 100644 --- a/src/proc/engine/stateproxy.hpp +++ b/src/proc/engine/stateproxy.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file stateproxy.hpp + ** TODO stateproxy.hpp */ diff --git a/src/proc/engine/time-anchor.hpp b/src/proc/engine/time-anchor.hpp index e83f968db..291dd9e5c 100644 --- a/src/proc/engine/time-anchor.hpp +++ b/src/proc/engine/time-anchor.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file time-anchor.hpp + ** TODO time-anchor.hpp */ diff --git a/src/proc/engine/tracking-heap-block-provider.cpp b/src/proc/engine/tracking-heap-block-provider.cpp index 1060b6a71..509ba7977 100644 --- a/src/proc/engine/tracking-heap-block-provider.cpp +++ b/src/proc/engine/tracking-heap-block-provider.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file tracking-heap-block-provider.cpp + ** TODO tracking-heap-block-provider.cpp */ diff --git a/src/proc/engine/worker/dummy-image-generator.cpp b/src/proc/engine/worker/dummy-image-generator.cpp index 93b20ead6..5b29372dc 100644 --- a/src/proc/engine/worker/dummy-image-generator.cpp +++ b/src/proc/engine/worker/dummy-image-generator.cpp @@ -22,8 +22,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file dummy-image-generator.cpp + ** TODO dummy-image-generator.cpp */ diff --git a/src/proc/external/libgavl.cpp b/src/proc/external/libgavl.cpp index 372839dbb..892869435 100644 --- a/src/proc/external/libgavl.cpp +++ b/src/proc/external/libgavl.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file libgavl.cpp + ** TODO libgavl.cpp */ diff --git a/src/proc/external/libgavl.hpp b/src/proc/external/libgavl.hpp index dc25134b1..b16da7e27 100644 --- a/src/proc/external/libgavl.hpp +++ b/src/proc/external/libgavl.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file libgavl.hpp + ** TODO libgavl.hpp */ diff --git a/src/proc/facade.cpp b/src/proc/facade.cpp index 1375b27dd..61f774fac 100644 --- a/src/proc/facade.cpp +++ b/src/proc/facade.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file facade.cpp + ** TODO facade.cpp */ diff --git a/src/proc/mobject/builder/assembler.cpp b/src/proc/mobject/builder/assembler.cpp index 12c127b3f..fc3fbe631 100644 --- a/src/proc/mobject/builder/assembler.cpp +++ b/src/proc/mobject/builder/assembler.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file assembler.cpp + ** TODO assembler.cpp */ diff --git a/src/proc/mobject/builder/assembler.hpp b/src/proc/mobject/builder/assembler.hpp index 8431791d5..054a10963 100644 --- a/src/proc/mobject/builder/assembler.hpp +++ b/src/proc/mobject/builder/assembler.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file assembler.hpp + ** TODO assembler.hpp */ diff --git a/src/proc/mobject/builder/common.hpp b/src/proc/mobject/builder/common.hpp index 0a792c0ac..c2d4e74e1 100644 --- a/src/proc/mobject/builder/common.hpp +++ b/src/proc/mobject/builder/common.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file common.hpp + ** TODO common.hpp */ diff --git a/src/proc/mobject/builder/conmanager.cpp b/src/proc/mobject/builder/conmanager.cpp index 8b2e57024..f08e769c2 100644 --- a/src/proc/mobject/builder/conmanager.cpp +++ b/src/proc/mobject/builder/conmanager.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file conmanager.cpp + ** TODO conmanager.cpp */ diff --git a/src/proc/mobject/builder/conmanager.hpp b/src/proc/mobject/builder/conmanager.hpp index 74650e11a..ff1fa0a61 100644 --- a/src/proc/mobject/builder/conmanager.hpp +++ b/src/proc/mobject/builder/conmanager.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file conmanager.hpp + ** TODO conmanager.hpp */ diff --git a/src/proc/mobject/builder/mould.hpp b/src/proc/mobject/builder/mould.hpp index f6b702185..c66af5271 100644 --- a/src/proc/mobject/builder/mould.hpp +++ b/src/proc/mobject/builder/mould.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file mould.hpp + ** TODO mould.hpp */ diff --git a/src/proc/mobject/builder/nodecreatortool.cpp b/src/proc/mobject/builder/nodecreatortool.cpp index f54aa2aa8..58c38644d 100644 --- a/src/proc/mobject/builder/nodecreatortool.cpp +++ b/src/proc/mobject/builder/nodecreatortool.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file nodecreatortool.cpp + ** TODO nodecreatortool.cpp */ diff --git a/src/proc/mobject/builder/nodecreatortool.hpp b/src/proc/mobject/builder/nodecreatortool.hpp index b585d3295..48686666a 100644 --- a/src/proc/mobject/builder/nodecreatortool.hpp +++ b/src/proc/mobject/builder/nodecreatortool.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file nodecreatortool.hpp + ** TODO nodecreatortool.hpp */ diff --git a/src/proc/mobject/builder/operationpoint.cpp b/src/proc/mobject/builder/operationpoint.cpp index 0d51ac960..9b118f896 100644 --- a/src/proc/mobject/builder/operationpoint.cpp +++ b/src/proc/mobject/builder/operationpoint.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file operationpoint.cpp + ** TODO operationpoint.cpp */ diff --git a/src/proc/mobject/builder/operationpoint.hpp b/src/proc/mobject/builder/operationpoint.hpp index 150b0d063..5d076a6ce 100644 --- a/src/proc/mobject/builder/operationpoint.hpp +++ b/src/proc/mobject/builder/operationpoint.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file operationpoint.hpp + ** TODO operationpoint.hpp */ diff --git a/src/proc/mobject/builder/renderstate.hpp b/src/proc/mobject/builder/renderstate.hpp index caa91f757..48e60a226 100644 --- a/src/proc/mobject/builder/renderstate.hpp +++ b/src/proc/mobject/builder/renderstate.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file renderstate.hpp + ** TODO renderstate.hpp */ diff --git a/src/proc/mobject/builder/segmentation-tool.cpp b/src/proc/mobject/builder/segmentation-tool.cpp index b71d5bece..c269f1e08 100644 --- a/src/proc/mobject/builder/segmentation-tool.cpp +++ b/src/proc/mobject/builder/segmentation-tool.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file segmentation-tool.cpp + ** TODO segmentation-tool.cpp */ diff --git a/src/proc/mobject/builder/segmentation-tool.hpp b/src/proc/mobject/builder/segmentation-tool.hpp index 645ddf115..3027fc3d2 100644 --- a/src/proc/mobject/builder/segmentation-tool.hpp +++ b/src/proc/mobject/builder/segmentation-tool.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file segmentation-tool.hpp + ** TODO segmentation-tool.hpp */ diff --git a/src/proc/mobject/builder/toolfactory.cpp b/src/proc/mobject/builder/toolfactory.cpp index b7d75c775..17cd300ab 100644 --- a/src/proc/mobject/builder/toolfactory.cpp +++ b/src/proc/mobject/builder/toolfactory.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file toolfactory.cpp + ** TODO toolfactory.cpp */ diff --git a/src/proc/mobject/builder/toolfactory.hpp b/src/proc/mobject/builder/toolfactory.hpp index 56cba1070..e5c495872 100644 --- a/src/proc/mobject/builder/toolfactory.hpp +++ b/src/proc/mobject/builder/toolfactory.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file toolfactory.hpp + ** TODO toolfactory.hpp */ diff --git a/src/proc/mobject/builder/wiringrequest.hpp b/src/proc/mobject/builder/wiringrequest.hpp index 94aea841e..59d390648 100644 --- a/src/proc/mobject/builder/wiringrequest.hpp +++ b/src/proc/mobject/builder/wiringrequest.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file wiringrequest.hpp + ** TODO wiringrequest.hpp */ diff --git a/src/proc/mobject/builderfacade.cpp b/src/proc/mobject/builderfacade.cpp index e5469d87d..5543aa885 100644 --- a/src/proc/mobject/builderfacade.cpp +++ b/src/proc/mobject/builderfacade.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file builderfacade.cpp + ** TODO builderfacade.cpp */ diff --git a/src/proc/mobject/builderfacade.hpp b/src/proc/mobject/builderfacade.hpp index b67562cf4..22963c6ae 100644 --- a/src/proc/mobject/builderfacade.hpp +++ b/src/proc/mobject/builderfacade.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file builderfacade.hpp + ** TODO builderfacade.hpp */ diff --git a/src/proc/mobject/explicitplacement.hpp b/src/proc/mobject/explicitplacement.hpp index d2492b98d..4628d5889 100644 --- a/src/proc/mobject/explicitplacement.hpp +++ b/src/proc/mobject/explicitplacement.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file explicitplacement.hpp + ** TODO explicitplacement.hpp */ diff --git a/src/proc/mobject/interpolator.cpp b/src/proc/mobject/interpolator.cpp index 1961e04e0..e0d2d4be3 100644 --- a/src/proc/mobject/interpolator.cpp +++ b/src/proc/mobject/interpolator.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file interpolator.cpp + ** TODO interpolator.cpp */ diff --git a/src/proc/mobject/interpolator.hpp b/src/proc/mobject/interpolator.hpp index 0a288c279..14c001713 100644 --- a/src/proc/mobject/interpolator.hpp +++ b/src/proc/mobject/interpolator.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file interpolator.hpp + ** TODO interpolator.hpp */ diff --git a/src/proc/mobject/mobject.cpp b/src/proc/mobject/mobject.cpp index 3c6c37c69..b7b18905d 100644 --- a/src/proc/mobject/mobject.cpp +++ b/src/proc/mobject/mobject.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file mobject.cpp + ** TODO mobject.cpp */ diff --git a/src/proc/mobject/mobject.hpp b/src/proc/mobject/mobject.hpp index 723a4fe40..6c68c46c4 100644 --- a/src/proc/mobject/mobject.hpp +++ b/src/proc/mobject/mobject.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file mobject.hpp + ** TODO mobject.hpp */ diff --git a/src/proc/mobject/output-designation.hpp b/src/proc/mobject/output-designation.hpp index 9c3412c46..3823c1c13 100644 --- a/src/proc/mobject/output-designation.hpp +++ b/src/proc/mobject/output-designation.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file output-designation.hpp + ** TODO output-designation.hpp */ diff --git a/src/proc/mobject/parameter.cpp b/src/proc/mobject/parameter.cpp index 6c0db28fd..d13179ec3 100644 --- a/src/proc/mobject/parameter.cpp +++ b/src/proc/mobject/parameter.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file parameter.cpp + ** TODO parameter.cpp */ diff --git a/src/proc/mobject/parameter.hpp b/src/proc/mobject/parameter.hpp index 320a3c2f4..3e22d138a 100644 --- a/src/proc/mobject/parameter.hpp +++ b/src/proc/mobject/parameter.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file parameter.hpp + ** TODO parameter.hpp */ diff --git a/src/proc/mobject/paramprovider.cpp b/src/proc/mobject/paramprovider.cpp index b83347da5..9571b8e28 100644 --- a/src/proc/mobject/paramprovider.cpp +++ b/src/proc/mobject/paramprovider.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file paramprovider.cpp + ** TODO paramprovider.cpp */ diff --git a/src/proc/mobject/paramprovider.hpp b/src/proc/mobject/paramprovider.hpp index 82261db32..881542ea5 100644 --- a/src/proc/mobject/paramprovider.hpp +++ b/src/proc/mobject/paramprovider.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file paramprovider.hpp + ** TODO paramprovider.hpp */ diff --git a/src/proc/mobject/placement.cpp b/src/proc/mobject/placement.cpp index e9ac34b46..70815632d 100644 --- a/src/proc/mobject/placement.cpp +++ b/src/proc/mobject/placement.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file placement.cpp + ** TODO placement.cpp */ diff --git a/src/proc/mobject/session/abstractmo.cpp b/src/proc/mobject/session/abstractmo.cpp index facf25532..bc00d335b 100644 --- a/src/proc/mobject/session/abstractmo.cpp +++ b/src/proc/mobject/session/abstractmo.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file abstractmo.cpp + ** TODO abstractmo.cpp */ diff --git a/src/proc/mobject/session/abstractmo.hpp b/src/proc/mobject/session/abstractmo.hpp index 5c300ca27..986197a80 100644 --- a/src/proc/mobject/session/abstractmo.hpp +++ b/src/proc/mobject/session/abstractmo.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file abstractmo.hpp + ** TODO abstractmo.hpp */ diff --git a/src/proc/mobject/session/allocation.cpp b/src/proc/mobject/session/allocation.cpp index 9d94b2701..8532b12f3 100644 --- a/src/proc/mobject/session/allocation.cpp +++ b/src/proc/mobject/session/allocation.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file allocation.cpp + ** TODO allocation.cpp */ diff --git a/src/proc/mobject/session/allocation.hpp b/src/proc/mobject/session/allocation.hpp index afb208e23..bc94389f4 100644 --- a/src/proc/mobject/session/allocation.hpp +++ b/src/proc/mobject/session/allocation.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file allocation.hpp + ** TODO allocation.hpp */ diff --git a/src/proc/mobject/session/auto.cpp b/src/proc/mobject/session/auto.cpp index a350124bc..5b1032a1a 100644 --- a/src/proc/mobject/session/auto.cpp +++ b/src/proc/mobject/session/auto.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file auto.cpp + ** TODO auto.cpp */ diff --git a/src/proc/mobject/session/auto.hpp b/src/proc/mobject/session/auto.hpp index 001e13ff7..1f542e247 100644 --- a/src/proc/mobject/session/auto.hpp +++ b/src/proc/mobject/session/auto.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file auto.hpp + ** TODO auto.hpp */ diff --git a/src/proc/mobject/session/binding.cpp b/src/proc/mobject/session/binding.cpp index 6abc12ce8..b116252e2 100644 --- a/src/proc/mobject/session/binding.cpp +++ b/src/proc/mobject/session/binding.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file binding.cpp + ** TODO binding.cpp */ diff --git a/src/proc/mobject/session/binding.hpp b/src/proc/mobject/session/binding.hpp index de23ac956..928ceec6d 100644 --- a/src/proc/mobject/session/binding.hpp +++ b/src/proc/mobject/session/binding.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file binding.hpp + ** TODO binding.hpp */ diff --git a/src/proc/mobject/session/bus-mo.cpp b/src/proc/mobject/session/bus-mo.cpp index e61fe8893..433a3f393 100644 --- a/src/proc/mobject/session/bus-mo.cpp +++ b/src/proc/mobject/session/bus-mo.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file bus-mo.cpp + ** TODO bus-mo.cpp */ diff --git a/src/proc/mobject/session/bus-mo.hpp b/src/proc/mobject/session/bus-mo.hpp index 9044058d1..d00e764df 100644 --- a/src/proc/mobject/session/bus-mo.hpp +++ b/src/proc/mobject/session/bus-mo.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file bus-mo.hpp + ** TODO bus-mo.hpp */ diff --git a/src/proc/mobject/session/clip.cpp b/src/proc/mobject/session/clip.cpp index 5f2479c41..8df40ec34 100644 --- a/src/proc/mobject/session/clip.cpp +++ b/src/proc/mobject/session/clip.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file clip.cpp + ** TODO clip.cpp */ diff --git a/src/proc/mobject/session/clip.hpp b/src/proc/mobject/session/clip.hpp index 0ddd11500..6c1f39098 100644 --- a/src/proc/mobject/session/clip.hpp +++ b/src/proc/mobject/session/clip.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file clip.hpp + ** TODO clip.hpp */ diff --git a/src/proc/mobject/session/constraint.cpp b/src/proc/mobject/session/constraint.cpp index 6f29e9dd9..b9e59aeb4 100644 --- a/src/proc/mobject/session/constraint.cpp +++ b/src/proc/mobject/session/constraint.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file constraint.cpp + ** TODO constraint.cpp */ diff --git a/src/proc/mobject/session/constraint.hpp b/src/proc/mobject/session/constraint.hpp index fec415780..9cdb3daee 100644 --- a/src/proc/mobject/session/constraint.hpp +++ b/src/proc/mobject/session/constraint.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file constraint.hpp + ** TODO constraint.hpp */ diff --git a/src/proc/mobject/session/effect.cpp b/src/proc/mobject/session/effect.cpp index 4d2916f10..760ac9771 100644 --- a/src/proc/mobject/session/effect.cpp +++ b/src/proc/mobject/session/effect.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file effect.cpp + ** TODO effect.cpp */ diff --git a/src/proc/mobject/session/effect.hpp b/src/proc/mobject/session/effect.hpp index 870a7e6c8..133cf80ca 100644 --- a/src/proc/mobject/session/effect.hpp +++ b/src/proc/mobject/session/effect.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file effect.hpp + ** TODO effect.hpp */ diff --git a/src/proc/mobject/session/element-query.hpp b/src/proc/mobject/session/element-query.hpp index 89e4e720b..e10d2f81f 100644 --- a/src/proc/mobject/session/element-query.hpp +++ b/src/proc/mobject/session/element-query.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file element-query.hpp + ** TODO element-query.hpp */ diff --git a/src/proc/mobject/session/fixedlocation.cpp b/src/proc/mobject/session/fixedlocation.cpp index fd22b04dd..115fe56d0 100644 --- a/src/proc/mobject/session/fixedlocation.cpp +++ b/src/proc/mobject/session/fixedlocation.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file fixedlocation.cpp + ** TODO fixedlocation.cpp */ diff --git a/src/proc/mobject/session/fixedlocation.hpp b/src/proc/mobject/session/fixedlocation.hpp index 6443748bc..d19a9e587 100644 --- a/src/proc/mobject/session/fixedlocation.hpp +++ b/src/proc/mobject/session/fixedlocation.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file fixedlocation.hpp + ** TODO fixedlocation.hpp */ diff --git a/src/proc/mobject/session/fixture.cpp b/src/proc/mobject/session/fixture.cpp index eb13a8263..ce2f1bcd7 100644 --- a/src/proc/mobject/session/fixture.cpp +++ b/src/proc/mobject/session/fixture.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file fixture.cpp + ** TODO fixture.cpp */ diff --git a/src/proc/mobject/session/fixture.hpp b/src/proc/mobject/session/fixture.hpp index de32267e3..06cc74617 100644 --- a/src/proc/mobject/session/fixture.hpp +++ b/src/proc/mobject/session/fixture.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file fixture.hpp + ** TODO fixture.hpp */ diff --git a/src/proc/mobject/session/fork.cpp b/src/proc/mobject/session/fork.cpp index 40881fdda..1d9a1e675 100644 --- a/src/proc/mobject/session/fork.cpp +++ b/src/proc/mobject/session/fork.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file fork.cpp + ** TODO fork.cpp */ diff --git a/src/proc/mobject/session/fork.hpp b/src/proc/mobject/session/fork.hpp index 9afa05fe8..73468e94e 100644 --- a/src/proc/mobject/session/fork.hpp +++ b/src/proc/mobject/session/fork.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file fork.hpp + ** TODO fork.hpp */ diff --git a/src/proc/mobject/session/generator-mo.cpp b/src/proc/mobject/session/generator-mo.cpp index 325475c43..6e836a480 100644 --- a/src/proc/mobject/session/generator-mo.cpp +++ b/src/proc/mobject/session/generator-mo.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file generator-mo.cpp + ** TODO generator-mo.cpp */ diff --git a/src/proc/mobject/session/generator-mo.hpp b/src/proc/mobject/session/generator-mo.hpp index f6bf43b33..059f012e7 100644 --- a/src/proc/mobject/session/generator-mo.hpp +++ b/src/proc/mobject/session/generator-mo.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file generator-mo.hpp + ** TODO generator-mo.hpp */ diff --git a/src/proc/mobject/session/label.cpp b/src/proc/mobject/session/label.cpp index 11db127ab..a292a9de0 100644 --- a/src/proc/mobject/session/label.cpp +++ b/src/proc/mobject/session/label.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file label.cpp + ** TODO label.cpp */ diff --git a/src/proc/mobject/session/label.hpp b/src/proc/mobject/session/label.hpp index 91f1a5916..906cb777b 100644 --- a/src/proc/mobject/session/label.hpp +++ b/src/proc/mobject/session/label.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file label.hpp + ** TODO label.hpp */ diff --git a/src/proc/mobject/session/locatingpin.cpp b/src/proc/mobject/session/locatingpin.cpp index 04e20d782..b0c29bbb3 100644 --- a/src/proc/mobject/session/locatingpin.cpp +++ b/src/proc/mobject/session/locatingpin.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file locatingpin.cpp + ** TODO locatingpin.cpp */ diff --git a/src/proc/mobject/session/meta.cpp b/src/proc/mobject/session/meta.cpp index 0c9a61983..1a14a64bc 100644 --- a/src/proc/mobject/session/meta.cpp +++ b/src/proc/mobject/session/meta.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file meta.cpp + ** TODO meta.cpp */ diff --git a/src/proc/mobject/session/meta.hpp b/src/proc/mobject/session/meta.hpp index b9dedb698..c5973dbe4 100644 --- a/src/proc/mobject/session/meta.hpp +++ b/src/proc/mobject/session/meta.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file meta.hpp + ** TODO meta.hpp */ diff --git a/src/proc/mobject/session/mobjectfactory.cpp b/src/proc/mobject/session/mobjectfactory.cpp index 3bca87f90..1941e73df 100644 --- a/src/proc/mobject/session/mobjectfactory.cpp +++ b/src/proc/mobject/session/mobjectfactory.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file mobjectfactory.cpp + ** TODO mobjectfactory.cpp */ diff --git a/src/proc/mobject/session/mobjectfactory.hpp b/src/proc/mobject/session/mobjectfactory.hpp index d50e5f771..16830e2d6 100644 --- a/src/proc/mobject/session/mobjectfactory.hpp +++ b/src/proc/mobject/session/mobjectfactory.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file mobjectfactory.hpp + ** TODO mobjectfactory.hpp */ diff --git a/src/proc/mobject/session/placement-index-query-resolver.cpp b/src/proc/mobject/session/placement-index-query-resolver.cpp index 4a457c924..8efc2606a 100644 --- a/src/proc/mobject/session/placement-index-query-resolver.cpp +++ b/src/proc/mobject/session/placement-index-query-resolver.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file placement-index-query-resolver.cpp + ** TODO placement-index-query-resolver.cpp */ diff --git a/src/proc/mobject/session/plug.cpp b/src/proc/mobject/session/plug.cpp index b01eef7d1..d6b05b451 100644 --- a/src/proc/mobject/session/plug.cpp +++ b/src/proc/mobject/session/plug.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file plug.cpp + ** TODO plug.cpp */ diff --git a/src/proc/mobject/session/plug.hpp b/src/proc/mobject/session/plug.hpp index 86f1155a9..f415825ed 100644 --- a/src/proc/mobject/session/plug.hpp +++ b/src/proc/mobject/session/plug.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file plug.hpp + ** TODO plug.hpp */ diff --git a/src/proc/mobject/session/query-focus-stack.hpp b/src/proc/mobject/session/query-focus-stack.hpp index c6c9d1ef1..25bc775df 100644 --- a/src/proc/mobject/session/query-focus-stack.hpp +++ b/src/proc/mobject/session/query-focus-stack.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file query-focus-stack.hpp + ** TODO query-focus-stack.hpp */ diff --git a/src/proc/mobject/session/query-focus.cpp b/src/proc/mobject/session/query-focus.cpp index a7465061e..f51f1e271 100644 --- a/src/proc/mobject/session/query-focus.cpp +++ b/src/proc/mobject/session/query-focus.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file query-focus.cpp + ** TODO query-focus.cpp */ diff --git a/src/proc/mobject/session/query-focus.hpp b/src/proc/mobject/session/query-focus.hpp index 1158fa3a7..dd68b74a9 100644 --- a/src/proc/mobject/session/query-focus.hpp +++ b/src/proc/mobject/session/query-focus.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file query-focus.hpp + ** TODO query-focus.hpp */ diff --git a/src/proc/mobject/session/query/fake-configrules.cpp b/src/proc/mobject/session/query/fake-configrules.cpp index a51e4cc91..492faeeb3 100644 --- a/src/proc/mobject/session/query/fake-configrules.cpp +++ b/src/proc/mobject/session/query/fake-configrules.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file fake-configrules.cpp + ** TODO fake-configrules.cpp */ diff --git a/src/proc/mobject/session/relativelocation.cpp b/src/proc/mobject/session/relativelocation.cpp index f6633de8a..a5d258e2c 100644 --- a/src/proc/mobject/session/relativelocation.cpp +++ b/src/proc/mobject/session/relativelocation.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file relativelocation.cpp + ** TODO relativelocation.cpp */ diff --git a/src/proc/mobject/session/relativelocation.hpp b/src/proc/mobject/session/relativelocation.hpp index 15c71d1bf..52b466893 100644 --- a/src/proc/mobject/session/relativelocation.hpp +++ b/src/proc/mobject/session/relativelocation.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file relativelocation.hpp + ** TODO relativelocation.hpp */ diff --git a/src/proc/mobject/session/root.cpp b/src/proc/mobject/session/root.cpp index 54a0b80dc..612328ca9 100644 --- a/src/proc/mobject/session/root.cpp +++ b/src/proc/mobject/session/root.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file root.cpp + ** TODO root.cpp */ diff --git a/src/proc/mobject/session/root.hpp b/src/proc/mobject/session/root.hpp index 16ed3991b..b2c42d0e4 100644 --- a/src/proc/mobject/session/root.hpp +++ b/src/proc/mobject/session/root.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file root.hpp + ** TODO root.hpp */ diff --git a/src/proc/mobject/session/scope-locator.hpp b/src/proc/mobject/session/scope-locator.hpp index c9fad72e8..44264dff8 100644 --- a/src/proc/mobject/session/scope-locator.hpp +++ b/src/proc/mobject/session/scope-locator.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file scope-locator.hpp + ** TODO scope-locator.hpp */ diff --git a/src/proc/mobject/session/scope-path.cpp b/src/proc/mobject/session/scope-path.cpp index fbbc744ad..6b17996b5 100644 --- a/src/proc/mobject/session/scope-path.cpp +++ b/src/proc/mobject/session/scope-path.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file scope-path.cpp + ** TODO scope-path.cpp */ diff --git a/src/proc/mobject/session/scope.hpp b/src/proc/mobject/session/scope.hpp index 322911287..10966f840 100644 --- a/src/proc/mobject/session/scope.hpp +++ b/src/proc/mobject/session/scope.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file scope.hpp + ** TODO scope.hpp */ diff --git a/src/proc/mobject/session/segment.cpp b/src/proc/mobject/session/segment.cpp index eaa169f02..2bdb5071e 100644 --- a/src/proc/mobject/session/segment.cpp +++ b/src/proc/mobject/session/segment.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file segment.cpp + ** TODO segment.cpp */ #include "proc/mobject/session/segment.hpp" diff --git a/src/proc/mobject/session/segment.hpp b/src/proc/mobject/session/segment.hpp index a4d8e3aab..ab094d934 100644 --- a/src/proc/mobject/session/segment.hpp +++ b/src/proc/mobject/session/segment.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file segment.hpp + ** TODO segment.hpp */ diff --git a/src/proc/mobject/session/segmentation.cpp b/src/proc/mobject/session/segmentation.cpp index f1ede1ab4..e13d75bef 100644 --- a/src/proc/mobject/session/segmentation.cpp +++ b/src/proc/mobject/session/segmentation.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file segmentation.cpp + ** TODO segmentation.cpp */ #include "proc/mobject/session/segmentation.hpp" diff --git a/src/proc/mobject/session/segmentation.hpp b/src/proc/mobject/session/segmentation.hpp index e7e0f4f61..f69baf58d 100644 --- a/src/proc/mobject/session/segmentation.hpp +++ b/src/proc/mobject/session/segmentation.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file segmentation.hpp + ** TODO segmentation.hpp */ diff --git a/src/proc/mobject/session/sess-manager-impl.hpp b/src/proc/mobject/session/sess-manager-impl.hpp index 9919f2a47..9dc6c5e58 100644 --- a/src/proc/mobject/session/sess-manager-impl.hpp +++ b/src/proc/mobject/session/sess-manager-impl.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file sess-manager-impl.hpp + ** TODO sess-manager-impl.hpp */ diff --git a/src/proc/mobject/session/session-impl.cpp b/src/proc/mobject/session/session-impl.cpp index 5979c5596..34f90b345 100644 --- a/src/proc/mobject/session/session-impl.cpp +++ b/src/proc/mobject/session/session-impl.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file session-impl.cpp + ** TODO session-impl.cpp */ diff --git a/src/proc/mobject/session/session-services.cpp b/src/proc/mobject/session/session-services.cpp index dd7cfbfed..2994660d6 100644 --- a/src/proc/mobject/session/session-services.cpp +++ b/src/proc/mobject/session/session-services.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file session-services.cpp + ** TODO session-services.cpp */ diff --git a/src/proc/mobject/session/specific-contents-query.hpp b/src/proc/mobject/session/specific-contents-query.hpp index a527d3978..fea11cccc 100644 --- a/src/proc/mobject/session/specific-contents-query.hpp +++ b/src/proc/mobject/session/specific-contents-query.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file specific-contents-query.hpp + ** TODO specific-contents-query.hpp */ diff --git a/src/proc/mobject/session/wish.cpp b/src/proc/mobject/session/wish.cpp index 6459d5b80..58f688e51 100644 --- a/src/proc/mobject/session/wish.cpp +++ b/src/proc/mobject/session/wish.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file wish.cpp + ** TODO wish.cpp */ diff --git a/src/proc/mobject/session/wish.hpp b/src/proc/mobject/session/wish.hpp index 13c5799d9..aaffbc3a5 100644 --- a/src/proc/mobject/session/wish.hpp +++ b/src/proc/mobject/session/wish.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file wish.hpp + ** TODO wish.hpp */ diff --git a/src/proc/play/dummy-play-connection.cpp b/src/proc/play/dummy-play-connection.cpp index ac5ad610e..afaad279e 100644 --- a/src/proc/play/dummy-play-connection.cpp +++ b/src/proc/play/dummy-play-connection.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file dummy-play-connection.cpp + ** TODO dummy-play-connection.cpp */ diff --git a/src/proc/play/dummy-player-service.cpp b/src/proc/play/dummy-player-service.cpp index 76025ac9b..04f227498 100644 --- a/src/proc/play/dummy-player-service.cpp +++ b/src/proc/play/dummy-player-service.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file dummy-player-service.cpp + ** TODO dummy-player-service.cpp */ diff --git a/src/proc/play/output-director.cpp b/src/proc/play/output-director.cpp index a259d3cf3..bd6f85dfd 100644 --- a/src/proc/play/output-director.cpp +++ b/src/proc/play/output-director.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file output-director.cpp + ** TODO output-director.cpp */ diff --git a/src/proc/play/output-slot.cpp b/src/proc/play/output-slot.cpp index 8899248d2..723aeb8a6 100644 --- a/src/proc/play/output-slot.cpp +++ b/src/proc/play/output-slot.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file output-slot.cpp + ** TODO output-slot.cpp */ diff --git a/src/proc/play/play-process.cpp b/src/proc/play/play-process.cpp index 126e59327..9d32fecf8 100644 --- a/src/proc/play/play-process.cpp +++ b/src/proc/play/play-process.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file play-process.cpp + ** TODO play-process.cpp */ diff --git a/src/proc/play/play-service.cpp b/src/proc/play/play-service.cpp index 7b8bef9d0..be686e971 100644 --- a/src/proc/play/play-service.cpp +++ b/src/proc/play/play-service.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file play-service.cpp + ** TODO play-service.cpp */ diff --git a/src/proc/play/render-configurator.cpp b/src/proc/play/render-configurator.cpp index 8e080e038..603bfb113 100644 --- a/src/proc/play/render-configurator.cpp +++ b/src/proc/play/render-configurator.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file render-configurator.cpp + ** TODO render-configurator.cpp */ diff --git a/src/proc/play/sound/jack-output.cpp b/src/proc/play/sound/jack-output.cpp index 3de0d6d2b..de7f7831a 100644 --- a/src/proc/play/sound/jack-output.cpp +++ b/src/proc/play/sound/jack-output.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file jack-output.cpp + ** TODO jack-output.cpp */ diff --git a/src/proc/play/timings.cpp b/src/proc/play/timings.cpp index c93923ba9..2f3ab126d 100644 --- a/src/proc/play/timings.cpp +++ b/src/proc/play/timings.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file timings.cpp + ** TODO timings.cpp */ diff --git a/src/proc/state.cpp b/src/proc/state.cpp index c70a24ecb..42779d4ab 100644 --- a/src/proc/state.cpp +++ b/src/proc/state.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file state.cpp + ** TODO state.cpp */ diff --git a/src/proc/state.hpp b/src/proc/state.hpp index 7ad7478d6..555ba257f 100644 --- a/src/proc/state.hpp +++ b/src/proc/state.hpp @@ -21,8 +21,8 @@ */ -/** @file §§§ - ** TODO §§§ +/** @file state.hpp + ** TODO state.hpp */ diff --git a/src/proc/streamtype.cpp b/src/proc/streamtype.cpp index c8f0d71d0..057256c93 100644 --- a/src/proc/streamtype.cpp +++ b/src/proc/streamtype.cpp @@ -21,8 +21,8 @@ * *****************************************************/ -/** @file §§§ - ** TODO §§§ +/** @file streamtype.cpp + ** TODO streamtype.cpp */ From dbc75fac7de53b27bed67686ebf4e3aa06328a41 Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Thu, 3 Nov 2016 18:26:43 +0100 Subject: [PATCH 03/26] Doxygen: we missed the plain C code --- src/backend/backend.c | 5 +++++ src/backend/backend.h | 5 +++++ src/backend/engine/engine-config.h | 5 +++++ src/backend/file-handling.c | 5 +++++ src/backend/filedescriptor.c | 5 +++++ src/backend/filedescriptorregistry.c | 5 +++++ src/backend/filehandle.c | 5 +++++ src/backend/filehandlecache.c | 5 +++++ src/backend/fileheader.c | 5 +++++ src/backend/mmap.c | 5 +++++ src/backend/mmapcache.c | 5 +++++ src/backend/mmapings.c | 5 +++++ src/backend/resourcecollector.c | 5 +++++ src/backend/resourcecollector.h | 5 +++++ src/backend/threadpool.c | 5 +++++ src/backend/threadpool.h | 5 +++++ src/backend/threads.c | 5 +++++ src/backend/threads.h | 5 +++++ src/common/config-interface.c | 5 +++++ src/common/config-wordlist.c | 5 +++++ src/common/config.c | 5 +++++ src/common/configentry.c | 5 +++++ src/common/configentry.h | 5 +++++ src/common/interface-descriptor.h | 5 +++++ src/include/dummy-player-facade.h | 5 +++++ src/include/play-facade.h | 5 +++++ src/lib/hash-fnv.c | 5 +++++ src/lib/lockerror.c | 5 +++++ src/lib/lockerror.h | 5 +++++ src/lib/luid.c | 5 +++++ src/lib/mpool.c | 5 +++++ src/lib/mpool.h | 5 +++++ src/lib/mrucache.c | 5 +++++ src/lib/priqueue.c | 5 +++++ src/lib/psplay.c | 5 +++++ src/lib/safeclib.c | 5 +++++ src/lib/sectionlock.h | 5 +++++ src/lib/tmpbuf.c | 5 +++++ src/tool/alsa.c | 5 +++++ src/tool/hello.c | 5 +++++ src/tool/main.c | 5 +++++ src/tool/rsvg-convert.c | 5 +++++ tests/backend/test-filedescriptors.c | 4 ++++ tests/backend/test-filehandles.c | 4 ++++ tests/backend/test-fileheader.c | 4 ++++ tests/backend/test-filemmap.c | 4 ++++ tests/backend/test-resourcecollector.c | 4 ++++ tests/backend/test-threadpool.c | 4 ++++ tests/backend/test-threads.c | 4 ++++ tests/core/application/test-configloader.c | 4 ++++ tests/core/application/test-interfaces.c | 4 ++++ tests/include/interface/say_hello.h | 4 ++++ tests/library/c-lib/test-errorstate.c | 4 ++++ tests/library/c-lib/test-llist.c | 4 ++++ tests/library/c-lib/test-locking.c | 4 ++++ tests/library/c-lib/test-luid.c | 4 ++++ tests/library/c-lib/test-mpool.c | 4 ++++ tests/library/c-lib/test-priqueue.c | 4 ++++ tests/library/c-lib/test-psplay.c | 4 ++++ tests/library/c-lib/test-safeclib.c | 4 ++++ tests/library/c-lib/test-slist.c | 4 ++++ tests/library/c-lib/test-time.c | 4 ++++ tests/plugin/test-c-plugin/example_plugin.c | 4 ++++ tests/tool/vgsuppression.c | 4 ++++ 64 files changed, 298 insertions(+) diff --git a/src/backend/backend.c b/src/backend/backend.c index 87b8ee42d..02b959f21 100644 --- a/src/backend/backend.c +++ b/src/backend/backend.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file backend.c + ** TODO backend.c + */ + + #include "include/logging.h" #include "lib/safeclib.h" #include "lib/tmpbuf.h" diff --git a/src/backend/backend.h b/src/backend/backend.h index e8b5f7b7b..a02613c34 100644 --- a/src/backend/backend.h +++ b/src/backend/backend.h @@ -21,6 +21,11 @@ */ +/** @file backend.h + ** TODO backend.h + */ + + #ifndef BACKEND_BACKEND_H #define BACKEND_BACKEND_H diff --git a/src/backend/engine/engine-config.h b/src/backend/engine/engine-config.h index 15459ef10..b85a84b31 100644 --- a/src/backend/engine/engine-config.h +++ b/src/backend/engine/engine-config.h @@ -21,6 +21,11 @@ */ +/** @file engine-config.h + ** TODO engine-config.h + */ + + #ifndef BACKEND_ENGINE_ENGINE_CONFIG_H #define BACKEND_ENGINE_ENGINE_CONFIG_H diff --git a/src/backend/file-handling.c b/src/backend/file-handling.c index df5326ded..beadd1b8f 100644 --- a/src/backend/file-handling.c +++ b/src/backend/file-handling.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file file-handling.c + ** TODO file-handling.c + */ + + #include "include/logging.h" #include "lib/mutex.h" #include "lib/safeclib.h" diff --git a/src/backend/filedescriptor.c b/src/backend/filedescriptor.c index b7320bf1c..c24847ca9 100644 --- a/src/backend/filedescriptor.c +++ b/src/backend/filedescriptor.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file filedescriptor.c + ** TODO filedescriptor.c + */ + + #include "include/logging.h" #include "lib/mutex.h" #include "lib/safeclib.h" diff --git a/src/backend/filedescriptorregistry.c b/src/backend/filedescriptorregistry.c index 9f7100de9..b9eb74657 100644 --- a/src/backend/filedescriptorregistry.c +++ b/src/backend/filedescriptorregistry.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file filedescriptorregistry.c + ** TODO filedescriptorregistry.c + */ + + #include "include/logging.h" #include "lib/safeclib.h" #include "lib/mutex.h" diff --git a/src/backend/filehandle.c b/src/backend/filehandle.c index 4f17f295a..61fa6699a 100644 --- a/src/backend/filehandle.c +++ b/src/backend/filehandle.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file filehandle.c + ** TODO filehandle.c + */ + + #include "include/logging.h" #include "lib/llist.h" #include "lib/safeclib.h" diff --git a/src/backend/filehandlecache.c b/src/backend/filehandlecache.c index b45bdf42c..7adc70664 100644 --- a/src/backend/filehandlecache.c +++ b/src/backend/filehandlecache.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file filehandlecache.c + ** TODO filehandlecache.c + */ + + #include "include/logging.h" #include "lib/safeclib.h" diff --git a/src/backend/fileheader.c b/src/backend/fileheader.c index c248acded..4df93a0f5 100644 --- a/src/backend/fileheader.c +++ b/src/backend/fileheader.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file fileheader.c + ** TODO fileheader.c + */ + + #include "lib/tmpbuf.h" #include "backend/fileheader.h" diff --git a/src/backend/mmap.c b/src/backend/mmap.c index 16d4f5328..d5950fe90 100644 --- a/src/backend/mmap.c +++ b/src/backend/mmap.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file mmap.c + ** TODO mmap.c + */ + + #include "include/logging.h" #include "lib/safeclib.h" diff --git a/src/backend/mmapcache.c b/src/backend/mmapcache.c index 4c6e6d247..4b6c8f99b 100644 --- a/src/backend/mmapcache.c +++ b/src/backend/mmapcache.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file mmapcache.c + ** TODO mmapcache.c + */ + + #include "include/logging.h" #include "lib/safeclib.h" diff --git a/src/backend/mmapings.c b/src/backend/mmapings.c index fe648362c..8aab635b5 100644 --- a/src/backend/mmapings.c +++ b/src/backend/mmapings.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file mmapings.c + ** TODO mmapings.c + */ + + #include "include/logging.h" #include "lib/mutex.h" #include "lib/safeclib.h" diff --git a/src/backend/resourcecollector.c b/src/backend/resourcecollector.c index 1dccc5e5e..48528977b 100644 --- a/src/backend/resourcecollector.c +++ b/src/backend/resourcecollector.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file resourcecollector.c + ** TODO resourcecollector.c + */ + + #include "include/logging.h" #include "lib/llist.h" #include "lib/mutex.h" diff --git a/src/backend/resourcecollector.h b/src/backend/resourcecollector.h index b428bdc8c..af2a6665b 100644 --- a/src/backend/resourcecollector.h +++ b/src/backend/resourcecollector.h @@ -21,6 +21,11 @@ */ +/** @file resourcecollector.h + ** TODO resourcecollector.h + */ + + #ifndef BACKEND_RESOURCECOLLECTOR_H #define BACKEND_RESOURCECOLLECTOR_H diff --git a/src/backend/threadpool.c b/src/backend/threadpool.c index ea01d5e46..16c43e645 100644 --- a/src/backend/threadpool.c +++ b/src/backend/threadpool.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file threadpool.c + ** TODO threadpool.c + */ + + #include "include/logging.h" #include "lib/safeclib.h" #include "backend/threadpool.h" diff --git a/src/backend/threadpool.h b/src/backend/threadpool.h index 509205ac1..caecfd9db 100644 --- a/src/backend/threadpool.h +++ b/src/backend/threadpool.h @@ -21,6 +21,11 @@ */ +/** @file threadpool.h + ** TODO threadpool.h + */ + + #ifndef BACKEND_THREADPOOL_H #define BACKEND_THREADPOOL_H diff --git a/src/backend/threads.c b/src/backend/threads.c index 811c99a64..46ad5083d 100644 --- a/src/backend/threads.c +++ b/src/backend/threads.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file threads.c + ** TODO threads.c + */ + + #include "include/logging.h" #include "lib/safeclib.h" #include "backend/threads.h" diff --git a/src/backend/threads.h b/src/backend/threads.h index 8dc40441e..454328ff5 100644 --- a/src/backend/threads.h +++ b/src/backend/threads.h @@ -21,6 +21,11 @@ */ +/** @file threads.h + ** TODO threads.h + */ + + #ifndef BACKEND_THREADS_H #define BACKEND_THREADS_H diff --git a/src/common/config-interface.c b/src/common/config-interface.c index 1f0abb1a9..e2bbcd48c 100644 --- a/src/common/config-interface.c +++ b/src/common/config-interface.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file config-interface.c + ** TODO config-interface.c + */ + + #include "common/config-interface.h" #include "common/config.h" diff --git a/src/common/config-wordlist.c b/src/common/config-wordlist.c index 245119686..2bc21f967 100644 --- a/src/common/config-wordlist.c +++ b/src/common/config-wordlist.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file config-wordlist.c + ** TODO config-wordlist.c + */ + + #include "include/logging.h" #include "lib/error.h" #include "lib/tmpbuf.h" diff --git a/src/common/config.c b/src/common/config.c index 15601eaf5..7d70d255e 100644 --- a/src/common/config.c +++ b/src/common/config.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file config.c + ** TODO config.c + */ + + #include "include/logging.h" #include "lib/safeclib.h" #include "lib/tmpbuf.h" diff --git a/src/common/configentry.c b/src/common/configentry.c index 11437ccf9..18336d9fe 100644 --- a/src/common/configentry.c +++ b/src/common/configentry.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file configentry.c + ** TODO configentry.c + */ + + #include "lib/safeclib.h" #include "common/configentry.h" diff --git a/src/common/configentry.h b/src/common/configentry.h index 58ea04691..066119148 100644 --- a/src/common/configentry.h +++ b/src/common/configentry.h @@ -21,6 +21,11 @@ */ +/** @file configentry.h + ** TODO configentry.h + */ + + #ifndef COMMON_CONFIGENTRY_H #define COMMON_CONFIGENTRY_H diff --git a/src/common/interface-descriptor.h b/src/common/interface-descriptor.h index 7be369a17..68babf6f5 100644 --- a/src/common/interface-descriptor.h +++ b/src/common/interface-descriptor.h @@ -21,6 +21,11 @@ */ +/** @file interface-descriptor.h + ** TODO interface-descriptor.h + */ + + #ifndef COMMON_INTERFACEDESCRIPTOR_H #define COMMON_INTERFACEDESCRIPTOR_H diff --git a/src/include/dummy-player-facade.h b/src/include/dummy-player-facade.h index ed59818c4..86aa55cd7 100644 --- a/src/include/dummy-player-facade.h +++ b/src/include/dummy-player-facade.h @@ -21,6 +21,11 @@ */ +/** @file dummy-player-facade.h + ** TODO dummy-player-facade.h + */ + + #ifndef PROC_INTERFACE_DUMMYPLAYER_H #define PROC_INTERFACE_DUMMYPLAYER_H diff --git a/src/include/play-facade.h b/src/include/play-facade.h index fced03316..0fc39066a 100644 --- a/src/include/play-facade.h +++ b/src/include/play-facade.h @@ -21,6 +21,11 @@ */ +/** @file play-facade.h + ** TODO play-facade.h + */ + + #ifndef PROC_INTERFACE_PLAY_H #define PROC_INTERFACE_PLAY_H diff --git a/src/lib/hash-fnv.c b/src/lib/hash-fnv.c index 8f932400a..9dae835d9 100644 --- a/src/lib/hash-fnv.c +++ b/src/lib/hash-fnv.c @@ -22,6 +22,11 @@ * *****************************************************/ +/** @file hash-fnv.c + ** TODO hash-fnv.c + */ + + #include "lib/hash-fnv.h" #include diff --git a/src/lib/lockerror.c b/src/lib/lockerror.c index 3295eff52..f78e6af09 100644 --- a/src/lib/lockerror.c +++ b/src/lib/lockerror.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file lockerror.c + ** TODO lockerror.c + */ + + #include "lib/lockerror.h" #include diff --git a/src/lib/lockerror.h b/src/lib/lockerror.h index 3c5293272..295a332e9 100644 --- a/src/lib/lockerror.h +++ b/src/lib/lockerror.h @@ -19,6 +19,11 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ + +/** @file lockerror.h + ** TODO lockerror.h + */ + #ifndef LUMIERA_LOCKERRORS_H #define LUMIERA_LOCKERRORS_H diff --git a/src/lib/luid.c b/src/lib/luid.c index d907060cb..a3cc11014 100644 --- a/src/lib/luid.c +++ b/src/lib/luid.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file luid.c + ** TODO luid.c + */ + + #include "lib/luid.h" #include diff --git a/src/lib/mpool.c b/src/lib/mpool.c index 724521c6f..469305037 100644 --- a/src/lib/mpool.c +++ b/src/lib/mpool.c @@ -19,6 +19,11 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ + +/** @file mpool.c + ** TODO mpool.c + */ + #include #include #include diff --git a/src/lib/mpool.h b/src/lib/mpool.h index b59ea2b58..bb7ddf184 100644 --- a/src/lib/mpool.h +++ b/src/lib/mpool.h @@ -19,6 +19,11 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ + +/** @file mpool.h + ** TODO mpool.h + */ + #include #include #include "lib/llist.h" diff --git a/src/lib/mrucache.c b/src/lib/mrucache.c index 272d66a3e..7eacc8339 100644 --- a/src/lib/mrucache.c +++ b/src/lib/mrucache.c @@ -19,6 +19,11 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ + +/** @file mrucache.c + ** TODO mrucache.c + */ + #include "lib/safeclib.h" #include "lib/mrucache.h" diff --git a/src/lib/priqueue.c b/src/lib/priqueue.c index ab667047d..10b79d6bc 100644 --- a/src/lib/priqueue.c +++ b/src/lib/priqueue.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file priqueue.c + ** TODO priqueue.c + */ + + #include "lib/priqueue.h" #include "include/logging.h" diff --git a/src/lib/psplay.c b/src/lib/psplay.c index e28840476..ae154a232 100644 --- a/src/lib/psplay.c +++ b/src/lib/psplay.c @@ -21,6 +21,11 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ + +/** @file psplay.c + ** TODO psplay.c + */ + #include "include/logging.h" #include "lib/psplay.h" diff --git a/src/lib/safeclib.c b/src/lib/safeclib.c index 980353273..8dc295956 100644 --- a/src/lib/safeclib.c +++ b/src/lib/safeclib.c @@ -18,6 +18,11 @@ along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ + + +/** @file safeclib.c + ** TODO safeclib.c + */ #include "lib/error.h" #include "lib/safeclib.h" diff --git a/src/lib/sectionlock.h b/src/lib/sectionlock.h index 0eb6cd93b..28245029d 100644 --- a/src/lib/sectionlock.h +++ b/src/lib/sectionlock.h @@ -19,6 +19,11 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ + +/** @file sectionlock.h + ** TODO sectionlock.h + */ + #ifndef LUMIERA_SECTIONLOCK_H #define LUMIERA_SECTIONLOCK_H diff --git a/src/lib/tmpbuf.c b/src/lib/tmpbuf.c index 46e42174a..59bb180f6 100644 --- a/src/lib/tmpbuf.c +++ b/src/lib/tmpbuf.c @@ -18,6 +18,11 @@ along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ + + +/** @file tmpbuf.c + ** TODO tmpbuf.c + */ #include "lib/safeclib.h" #include "lib/tmpbuf.h" diff --git a/src/tool/alsa.c b/src/tool/alsa.c index 68969f49a..738a95a8e 100644 --- a/src/tool/alsa.c +++ b/src/tool/alsa.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file alsa.c + ** TODO alsa.c + */ + + #include "alsa.h" #include diff --git a/src/tool/hello.c b/src/tool/hello.c index 43b3c3291..6de1b0003 100644 --- a/src/tool/hello.c +++ b/src/tool/hello.c @@ -3,6 +3,11 @@ * integrated into the SCons based build system of Lumiera */ + +/** @file hello.c + ** TODO hello.c + */ + #include int diff --git a/src/tool/main.c b/src/tool/main.c index 86a027b41..7887362c8 100644 --- a/src/tool/main.c +++ b/src/tool/main.c @@ -21,6 +21,11 @@ * *****************************************************/ +/** @file main.c + ** TODO main.c + */ + + #include "alsa.h" #include diff --git a/src/tool/rsvg-convert.c b/src/tool/rsvg-convert.c index eee28cc07..46a21dc78 100644 --- a/src/tool/rsvg-convert.c +++ b/src/tool/rsvg-convert.c @@ -24,6 +24,11 @@ * *****************************************************/ +/** @file rsvg-convert.c + ** TODO rsvg-convert.c + */ + + #ifndef N_ #define N_(X) X #endif diff --git a/tests/backend/test-filedescriptors.c b/tests/backend/test-filedescriptors.c index 11fb41390..5f03995e1 100644 --- a/tests/backend/test-filedescriptors.c +++ b/tests/backend/test-filedescriptors.c @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/safeclib.h" diff --git a/tests/backend/test-filehandles.c b/tests/backend/test-filehandles.c index 9abc38fad..57b113984 100644 --- a/tests/backend/test-filehandles.c +++ b/tests/backend/test-filehandles.c @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/llist.h" #include "lib/tmpbuf.h" diff --git a/tests/backend/test-fileheader.c b/tests/backend/test-fileheader.c index 960680602..7af584673 100644 --- a/tests/backend/test-fileheader.c +++ b/tests/backend/test-fileheader.c @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "backend/backend.h" #include "backend/fileheader.h" diff --git a/tests/backend/test-filemmap.c b/tests/backend/test-filemmap.c index 31abae0f9..977401aed 100644 --- a/tests/backend/test-filemmap.c +++ b/tests/backend/test-filemmap.c @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + //#include //#include diff --git a/tests/backend/test-resourcecollector.c b/tests/backend/test-resourcecollector.c index b6809cf07..583ca132d 100644 --- a/tests/backend/test-resourcecollector.c +++ b/tests/backend/test-resourcecollector.c @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "backend/resourcecollector.h" diff --git a/tests/backend/test-threadpool.c b/tests/backend/test-threadpool.c index 807dc1d66..da329ed69 100644 --- a/tests/backend/test-threadpool.c +++ b/tests/backend/test-threadpool.c @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/test.h" diff --git a/tests/backend/test-threads.c b/tests/backend/test-threads.c index 23de08ec3..6598c29e5 100644 --- a/tests/backend/test-threads.c +++ b/tests/backend/test-threads.c @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + //#include //#include diff --git a/tests/core/application/test-configloader.c b/tests/core/application/test-configloader.c index 9af8b7b18..1ef7c2c7f 100644 --- a/tests/core/application/test-configloader.c +++ b/tests/core/application/test-configloader.c @@ -21,6 +21,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/tmpbuf.h" diff --git a/tests/core/application/test-interfaces.c b/tests/core/application/test-interfaces.c index c6cefe06f..b24b9738a 100644 --- a/tests/core/application/test-interfaces.c +++ b/tests/core/application/test-interfaces.c @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "common/interface.h" #include "common/interfaceregistry.h" diff --git a/tests/include/interface/say_hello.h b/tests/include/interface/say_hello.h index 8155879c4..d9696e57b 100644 --- a/tests/include/interface/say_hello.h +++ b/tests/include/interface/say_hello.h @@ -3,6 +3,10 @@ /* one interface which can greet in different languages */ + +/** @file §§§ + ** unit test TODO §§§ + */ LUMIERA_INTERFACE_DECLARE (lumieraorg_testhello, 0, LUMIERA_INTERFACE_SLOT (void, hello, (void)), LUMIERA_INTERFACE_SLOT (void, goodbye, (const char*)), diff --git a/tests/library/c-lib/test-errorstate.c b/tests/library/c-lib/test-errorstate.c index b936c1d30..1b9a54ec8 100644 --- a/tests/library/c-lib/test-errorstate.c +++ b/tests/library/c-lib/test-errorstate.c @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include #include diff --git a/tests/library/c-lib/test-llist.c b/tests/library/c-lib/test-llist.c index 85162e608..26fce3751 100644 --- a/tests/library/c-lib/test-llist.c +++ b/tests/library/c-lib/test-llist.c @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include diff --git a/tests/library/c-lib/test-locking.c b/tests/library/c-lib/test-locking.c index c883dc2ff..5c4da0538 100644 --- a/tests/library/c-lib/test-locking.c +++ b/tests/library/c-lib/test-locking.c @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/test.h" #include "lib/mutex.h" diff --git a/tests/library/c-lib/test-luid.c b/tests/library/c-lib/test-luid.c index f2902c74b..d87809168 100644 --- a/tests/library/c-lib/test-luid.c +++ b/tests/library/c-lib/test-luid.c @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/luid.h" diff --git a/tests/library/c-lib/test-mpool.c b/tests/library/c-lib/test-mpool.c index 5667a2506..09331ad0b 100644 --- a/tests/library/c-lib/test-mpool.c +++ b/tests/library/c-lib/test-mpool.c @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/test.h" #include "lib/mpool.h" diff --git a/tests/library/c-lib/test-priqueue.c b/tests/library/c-lib/test-priqueue.c index bc6459c15..46589264f 100644 --- a/tests/library/c-lib/test-priqueue.c +++ b/tests/library/c-lib/test-priqueue.c @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/test.h" #include "lib/priqueue.h" diff --git a/tests/library/c-lib/test-psplay.c b/tests/library/c-lib/test-psplay.c index dc50bb548..6cae14716 100644 --- a/tests/library/c-lib/test-psplay.c +++ b/tests/library/c-lib/test-psplay.c @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include #include diff --git a/tests/library/c-lib/test-safeclib.c b/tests/library/c-lib/test-safeclib.c index 63e503b4a..d6a322144 100644 --- a/tests/library/c-lib/test-safeclib.c +++ b/tests/library/c-lib/test-safeclib.c @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/safeclib.h" #include "lib/tmpbuf.h" /* not factored out yet */ diff --git a/tests/library/c-lib/test-slist.c b/tests/library/c-lib/test-slist.c index b18374194..8b5a8a6a7 100644 --- a/tests/library/c-lib/test-slist.c +++ b/tests/library/c-lib/test-slist.c @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/slist.h" #include "lib/test/test.h" diff --git a/tests/library/c-lib/test-time.c b/tests/library/c-lib/test-time.c index 67c42c133..02ba321b0 100644 --- a/tests/library/c-lib/test-time.c +++ b/tests/library/c-lib/test-time.c @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include "lib/test/test.h" #include "lib/time.h" diff --git a/tests/plugin/test-c-plugin/example_plugin.c b/tests/plugin/test-c-plugin/example_plugin.c index 2ac408a7a..d67c80156 100644 --- a/tests/plugin/test-c-plugin/example_plugin.c +++ b/tests/plugin/test-c-plugin/example_plugin.c @@ -20,6 +20,10 @@ * *****************************************************/ +/** @file §§§ + ** unit test TODO §§§ + */ + #include diff --git a/tests/tool/vgsuppression.c b/tests/tool/vgsuppression.c index 852cc3bc4..82f7ff474 100644 --- a/tests/tool/vgsuppression.c +++ b/tests/tool/vgsuppression.c @@ -19,6 +19,10 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ +/** @file §§§ + ** unit test TODO §§§ + */ + /* just place any problematic calls where valgrind whines about in main (with comments please) */ From ddc915db4152599ffa316922f976895a93cefc70 Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Thu, 3 Nov 2016 19:37:34 +0100 Subject: [PATCH 04/26] Doxygen: fill in missing file level headlines for the Backend --- src/backend/backend.c | 2 +- src/backend/backend.h | 2 +- src/backend/engine/engine-config.cpp | 2 +- src/backend/engine/engine-config.h | 2 +- src/backend/engine/scheduler-frontend.cpp | 2 +- src/backend/engine/scheduler-frontend.hpp | 3 ++- src/backend/enginefacade.cpp | 8 +++++++- src/backend/enginefacade.hpp | 5 ++++- src/backend/file-handling.c | 2 +- src/backend/filedescriptor.c | 5 +++-- src/backend/filedescriptorregistry.c | 3 ++- src/backend/filehandle.c | 3 ++- src/backend/filehandlecache.c | 3 ++- src/backend/fileheader.c | 4 +++- src/backend/media-access-facade.cpp | 5 ++++- src/backend/media-access-facade.hpp | 8 +++++++- src/backend/mmap.c | 3 ++- src/backend/mmapcache.c | 3 ++- src/backend/mmapings.c | 3 ++- src/backend/netnodefacade.cpp | 5 ++++- src/backend/netnodefacade.hpp | 5 ++++- src/backend/real-clock.cpp | 9 +++++++-- src/backend/resourcecollector.c | 3 ++- src/backend/resourcecollector.h | 3 ++- src/backend/scriptrunnerfacade.cpp | 6 +++++- src/backend/scriptrunnerfacade.hpp | 5 ++++- src/backend/thread-wrapper.hpp | 11 ++++++++++- src/backend/threadpool-init.cpp | 2 +- src/backend/threadpool-init.hpp | 2 +- src/backend/threadpool.c | 4 +++- src/backend/threadpool.h | 2 +- src/backend/threads.c | 3 ++- src/backend/threads.h | 5 ++++- 33 files changed, 98 insertions(+), 35 deletions(-) diff --git a/src/backend/backend.c b/src/backend/backend.c index 02b959f21..a0f909b35 100644 --- a/src/backend/backend.c +++ b/src/backend/backend.c @@ -22,7 +22,7 @@ /** @file backend.c - ** TODO backend.c + ** Lumiera Backend: implementation of global initialisation and services. */ diff --git a/src/backend/backend.h b/src/backend/backend.h index a02613c34..5eb00217f 100644 --- a/src/backend/backend.h +++ b/src/backend/backend.h @@ -22,7 +22,7 @@ /** @file backend.h - ** TODO backend.h + ** Lumiera Backend: global initialisation and definitions. */ diff --git a/src/backend/engine/engine-config.cpp b/src/backend/engine/engine-config.cpp index 3d14a93ec..93b10528f 100644 --- a/src/backend/engine/engine-config.cpp +++ b/src/backend/engine/engine-config.cpp @@ -22,7 +22,7 @@ /** @file engine-config.cpp - ** TODO engine-config.cpp + ** implementation of engine configuration and parametrisation */ diff --git a/src/backend/engine/engine-config.h b/src/backend/engine/engine-config.h index b85a84b31..89df108a9 100644 --- a/src/backend/engine/engine-config.h +++ b/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 */ diff --git a/src/backend/engine/scheduler-frontend.cpp b/src/backend/engine/scheduler-frontend.cpp index 2e38a6bd0..7e4aff0c1 100644 --- a/src/backend/engine/scheduler-frontend.cpp +++ b/src/backend/engine/scheduler-frontend.cpp @@ -22,7 +22,7 @@ /** @file scheduler-frontend.cpp - ** TODO scheduler-frontend.cpp + ** Scheduler service implementation */ diff --git a/src/backend/engine/scheduler-frontend.hpp b/src/backend/engine/scheduler-frontend.hpp index ad8a4fb56..d0c841be9 100644 --- a/src/backend/engine/scheduler-frontend.hpp +++ b/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 */ diff --git a/src/backend/enginefacade.cpp b/src/backend/enginefacade.cpp index 14aa9e0d1..75485cfe6 100644 --- a/src/backend/enginefacade.cpp +++ b/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 + ** */ diff --git a/src/backend/enginefacade.hpp b/src/backend/enginefacade.hpp index 0a4d1604c..1d0634f59 100644 --- a/src/backend/enginefacade.hpp +++ b/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. */ diff --git a/src/backend/file-handling.c b/src/backend/file-handling.c index beadd1b8f..1fd1a3861 100644 --- a/src/backend/file-handling.c +++ b/src/backend/file-handling.c @@ -22,7 +22,7 @@ /** @file file-handling.c - ** TODO file-handling.c + ** Implementation of file management functions */ diff --git a/src/backend/filedescriptor.c b/src/backend/filedescriptor.c index c24847ca9..180bd5d13 100644 --- a/src/backend/filedescriptor.c +++ b/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) { diff --git a/src/backend/filedescriptorregistry.c b/src/backend/filedescriptorregistry.c index b9eb74657..8717d25e4 100644 --- a/src/backend/filedescriptorregistry.c +++ b/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 */ diff --git a/src/backend/filehandle.c b/src/backend/filehandle.c index 61fa6699a..4557bc558 100644 --- a/src/backend/filehandle.c +++ b/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 */ diff --git a/src/backend/filehandlecache.c b/src/backend/filehandlecache.c index 7adc70664..2cd0046e5 100644 --- a/src/backend/filehandlecache.c +++ b/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 */ diff --git a/src/backend/fileheader.c b/src/backend/fileheader.c index 4df93a0f5..1fe269d76 100644 --- a/src/backend/fileheader.c +++ b/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 */ diff --git a/src/backend/media-access-facade.cpp b/src/backend/media-access-facade.cpp index 00906d0fd..889150272 100644 --- a/src/backend/media-access-facade.cpp +++ b/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. */ diff --git a/src/backend/media-access-facade.hpp b/src/backend/media-access-facade.hpp index abfe4ae6b..c398f003d 100644 --- a/src/backend/media-access-facade.hpp +++ b/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. */ diff --git a/src/backend/mmap.c b/src/backend/mmap.c index d5950fe90..fa9537ac0 100644 --- a/src/backend/mmap.c +++ b/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 */ diff --git a/src/backend/mmapcache.c b/src/backend/mmapcache.c index 4b6c8f99b..9610579d6 100644 --- a/src/backend/mmapcache.c +++ b/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 */ diff --git a/src/backend/mmapings.c b/src/backend/mmapings.c index 8aab635b5..8107aa177 100644 --- a/src/backend/mmapings.c +++ b/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 */ diff --git a/src/backend/netnodefacade.cpp b/src/backend/netnodefacade.cpp index a91662164..696081cf3 100644 --- a/src/backend/netnodefacade.cpp +++ b/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 */ diff --git a/src/backend/netnodefacade.hpp b/src/backend/netnodefacade.hpp index e759a579c..d4090c6b8 100644 --- a/src/backend/netnodefacade.hpp +++ b/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 */ diff --git a/src/backend/real-clock.cpp b/src/backend/real-clock.cpp index b7865c232..aecf4d883 100644 --- a/src/backend/real-clock.cpp +++ b/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 @@ -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 */ diff --git a/src/backend/resourcecollector.c b/src/backend/resourcecollector.c index 48528977b..86a8411c0 100644 --- a/src/backend/resourcecollector.c +++ b/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 */ diff --git a/src/backend/resourcecollector.h b/src/backend/resourcecollector.h index af2a6665b..2108335e4 100644 --- a/src/backend/resourcecollector.h +++ b/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 */ diff --git a/src/backend/scriptrunnerfacade.cpp b/src/backend/scriptrunnerfacade.cpp index 90663edd1..f745e3c70 100644 --- a/src/backend/scriptrunnerfacade.cpp +++ b/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 */ diff --git a/src/backend/scriptrunnerfacade.hpp b/src/backend/scriptrunnerfacade.hpp index 19a5cb40f..e6d46e58b 100644 --- a/src/backend/scriptrunnerfacade.hpp +++ b/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 */ diff --git a/src/backend/thread-wrapper.hpp b/src/backend/thread-wrapper.hpp index 7165d314f..689fa54e4 100644 --- a/src/backend/thread-wrapper.hpp +++ b/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. */ diff --git a/src/backend/threadpool-init.cpp b/src/backend/threadpool-init.cpp index 296b65ade..2634d028c 100644 --- a/src/backend/threadpool-init.cpp +++ b/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. */ diff --git a/src/backend/threadpool-init.hpp b/src/backend/threadpool-init.hpp index 05fe29370..303ec1e00 100644 --- a/src/backend/threadpool-init.hpp +++ b/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. ** diff --git a/src/backend/threadpool.c b/src/backend/threadpool.c index 16c43e645..c00e94631 100644 --- a/src/backend/threadpool.c +++ b/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 */ diff --git a/src/backend/threadpool.h b/src/backend/threadpool.h index caecfd9db..4298ad74e 100644 --- a/src/backend/threadpool.h +++ b/src/backend/threadpool.h @@ -22,7 +22,7 @@ /** @file threadpool.h - ** TODO threadpool.h + ** @todo development in this area is stalled since 2010 */ diff --git a/src/backend/threads.c b/src/backend/threads.c index 46ad5083d..3c719eb13 100644 --- a/src/backend/threads.c +++ b/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 */ diff --git a/src/backend/threads.h b/src/backend/threads.h index 454328ff5..cf30bcc69 100644 --- a/src/backend/threads.h +++ b/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 */ From aa335b560507ac954cb12952a2e74c28178f4b40 Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Fri, 4 Nov 2016 21:26:56 +0100 Subject: [PATCH 05/26] Doxygen: fill in missing file level headlines for config and query frameworks Added warning tags to several headers of the first config system draft from 2008 since this effort is stalled and likely to be implemented differently --- src/common/advice/advice.cpp | 8 ++-- src/common/advice/binding.cpp | 8 +++- src/common/advice/binding.hpp | 6 +-- src/common/config-interface.c | 5 ++- src/common/config-interface.h | 3 ++ src/common/config-lookup.c | 3 ++ src/common/config-lookup.h | 25 ++++++----- src/common/config-rules.hpp | 11 ++--- src/common/config-typed.c | 5 ++- src/common/config-wordlist.c | 6 ++- src/common/config.c | 4 +- src/common/config.h | 2 + src/common/configentry.c | 4 +- src/common/configentry.h | 4 +- src/common/configfacade.cpp | 15 ++++++- src/common/configitem.c | 5 ++- src/common/configitem.h | 6 ++- src/common/query/config-rules.cpp | 3 +- src/common/query/defs-manager.hpp | 67 ++++++++++++++++++++++++++++- src/common/query/defs-registry.hpp | 2 +- src/common/query/query-resolver.cpp | 11 ++++- src/common/query/query-resolver.hpp | 8 +++- src/include/config-facade.h | 10 ++++- 23 files changed, 180 insertions(+), 41 deletions(-) diff --git a/src/common/advice/advice.cpp b/src/common/advice/advice.cpp index 6271ad6ca..178b288cf 100644 --- a/src/common/advice/advice.cpp +++ b/src/common/advice/advice.cpp @@ -22,7 +22,7 @@ /** @file advice.cpp - ** Implementation the AdviceSystem, to support the advice collaboration. + ** Implementation of the AdviceSystem, to support the advice collaboration. ** The AdviceSystem is implemented as singleton, but is never accessed directly ** by clients participating in an advice collaboration. Rather, they use the ** advice::Request and advice::Provision value classes as a frontend. While @@ -32,7 +32,7 @@ ** implemented in this compilation unit and access the AdviceSystem singleton ** defined here locally. ** - ** \par memory management + ** ## memory management ** Advice data, when added by an advice::Provision, is copied into a ActiveProvision, ** which acts as a value holding buffer. This way, the provided advice data is copied ** into storage managed by the AdviceSystem, allowing to access the data even after the @@ -53,7 +53,7 @@ ** @note when a Provision is copied, this hidden link is not shared with the copy, which ** therefore behaves as if newly created with the same binding, but without providing Advice. ** - ** \par implementing the allocations + ** ## implementing the allocations ** The problem with copying and incorporating the ActiveProvision objects is the undetermined ** size of these value holders, because the frontend objects are templated on the advice type, ** while the AdviceSystem doesn't have any knowledge of the specific advice type. This advice @@ -73,7 +73,7 @@ ** ** @todo rewrite the allocation to use Lumiera's MPool instead of heap allocations //////TICKET #609 ** - ** \par synchronisation + ** ## synchronisation ** While the frontend objects are deliberately \em not threadsafe, the lookup implementation ** within the AdviceSystem uses a system wide advice::Index table and thus needs locking. ** Besides the protection against corrupting the index, this also serves as memory barrier, diff --git a/src/common/advice/binding.cpp b/src/common/advice/binding.cpp index b18436829..fae7f1df4 100644 --- a/src/common/advice/binding.cpp +++ b/src/common/advice/binding.cpp @@ -22,7 +22,11 @@ /** @file binding.cpp - ** TODO binding.cpp + ** Implementation of a binding record to represent a match between two patterns. + ** This is used for the Advice System, to record existing connections between + ** advice providers and consumers. But as such, Binding is a generic mechanism + ** and looks like it could be of wider use within the Lumiera application. + ** This is the reason why Binding got a separate implementation `cpp` file. */ @@ -62,7 +66,7 @@ namespace advice { const string matchArg = "\\(\\s*"+matchSym+"?\\s*\\)"; regex findPredicate ("\\s*"+matchSym+"("+matchArg+")?\\s*,?"); ///< \c sym(arg), groups: [symbol, parenthesis, argument symbol] - /** detect the \em arity of an predicate, as matched by #findPredicate. + /** detect the _arity_ of an predicate, as matched by #findPredicate. * Currently, we don't really parse predicate logic notation and thus we * just distinguish nullary predicates (no argument) and predicates with * one single constant argument. */ diff --git a/src/common/advice/binding.hpp b/src/common/advice/binding.hpp index 8b92bbd99..699e113db 100644 --- a/src/common/advice/binding.hpp +++ b/src/common/advice/binding.hpp @@ -30,7 +30,7 @@ ** each specifying a binding, they can be paired up if any condition included into the binding ** holds true for both sides. ** - ** Typically, a binding includes a \em type-guard predicate \c advice.type.xx where \c xx is an + ** Typically, a binding includes a _type-guard predicate_ `advice.type.xx` where `xx` is an ** identifier denoting a type used within an instantiation of the Advice collaboration, i.e. a type ** used as advice value in a instantiation of the PointOfAdvice template. Besides the type guard, ** a binding may narrow down the topic of the advice by providing further predicates. This allows for @@ -41,7 +41,7 @@ ** the advice type, and another client entity (the advised entity) could pick up this value ** without the need to now anything about the advisor. ** - ** \par implementation notes + ** # implementation notes ** Any binding will be normalised prior to further processing. This normalisation is based ** on ordering by predicate symbol and arity. Patterns just comprised of constant symbols ** (nullary atoms) can even be condensed into a single hash value, which allows for fast @@ -56,7 +56,7 @@ ** functor, the full pattern definition can be discarded. ** ** @remarks while binding is defined in the context of the advice system for now, - ** obviously this is the foundation of a more generic system to deal with predicate terms. + ** obviously this is the foundation of a more generic system to deal with predicate terms. ** @note as of 4/2010 this is an experimental setup and implemented just enough to work out ** the interfaces. Ichthyo expects this collaboration service to play a central role ** at various places within proc-layer. diff --git a/src/common/config-interface.c b/src/common/config-interface.c index e2bbcd48c..d71196443 100644 --- a/src/common/config-interface.c +++ b/src/common/config-interface.c @@ -22,7 +22,10 @@ /** @file config-interface.c - ** TODO config-interface.c + ** A public interface to a (planned) global configuration system. + ** This is part of a drafted configuration system (2008). + ** @todo as of 2016 this code is unused and + ** likely to be replaced by a different approach. */ diff --git a/src/common/config-interface.h b/src/common/config-interface.h index ebca9d573..21b0a8691 100644 --- a/src/common/config-interface.h +++ b/src/common/config-interface.h @@ -28,6 +28,9 @@ ** planned in 2008). ** ** @note this is unfinished work, development in this area stalled in 2008 + ** @warning since 2012 it is not clear if we retain this kind of configuration system. + ** @todo as of 2016, the code is still there in same unfinished shape and basically unused + ** ** @see config.h */ diff --git a/src/common/config-lookup.c b/src/common/config-lookup.c index a6603db60..58eda6359 100644 --- a/src/common/config-lookup.c +++ b/src/common/config-lookup.c @@ -22,7 +22,10 @@ /** @file config-lookup.c + ** Implementation draft for a configuration system (2008). ** Implementation of the lookup of configuration keys + ** @todo as of 2016 this code is unused and + ** likely to be replaced by a different approach. */ diff --git a/src/common/config-lookup.h b/src/common/config-lookup.h index ad512b354..0acff34c8 100644 --- a/src/common/config-lookup.h +++ b/src/common/config-lookup.h @@ -21,6 +21,19 @@ */ +/** @file config-lookup.h + ** Lookup of configuration keys in a low-level configuration system. + ** Configuration keys are dynamically stored in a splay tree. + ** This happens for defaults, loaded config files and entries which are set explicitly. + ** The system maintains no central registry of all possible keys. + ** We store here the full keys of config entries as well as the keys of section prefixes. + ** Section prefixes are stored with a trailing dot to disambiguate them from entry keys. + ** + ** @warning since 2012 it is not clear if we retain this kind of configuration system. + ** @todo as of 2016, the code is still there but remains mostly unused + */ + + #ifndef COMMON_CONFIG_LOOKUP_H #define COMMON_CONFIG_LOOKUP_H @@ -37,22 +50,12 @@ typedef lumiera_config_lookupentry* LumieraConfigLookupentry; #include "common/configitem.h" - #include -/** - * @file - * Lookup of configuration keys. Configuration keys are dynamically stored in a splay tree. - * This happens for defaults, loaded config files and entries which are set explicitly. - * The system maintains no central registry of all possible keys. - * We store here the full keys of config entries as well as the keys of section prefixes. - * Section prefixes are stored with a trailing dot to disambiguate them from entry keys. - */ - - LUMIERA_ERROR_DECLARE (CONFIG_LOOKUP); + /** * Just contains a hashtable to give sufficient abstraction. */ diff --git a/src/common/config-rules.hpp b/src/common/config-rules.hpp index c583575ba..549fb1bc0 100644 --- a/src/common/config-rules.hpp +++ b/src/common/config-rules.hpp @@ -26,10 +26,10 @@ ** By using the Query template, you can pose a query in prolog syntax and get some ** existing or newly created object fulfilling the requested predicates. The actual ** implementation is hidden behind the #instance (Singleton factory). As of 1/2008, - ** it is \e planned to use an embedded YAP Prolog system at some point in the future, - ** for now we use a \link MockConfigRules mock implementation \endlink employing a - ** preconfigured Map. - ** + ** it is _planned_ to use an embedded YAP Prolog system at some point in the future, + ** for now we use a [mock implementation](\ref MockConfigRules) based on lookup in + ** a hard-wired, preconfigured Map. + ** ** Fully implementing this facility would require the participating objects to register capabilities ** they want to provide, together with functors carrying out the necessary configuration steps. ** All details and consequences of this approach still have to be worked out... @@ -47,13 +47,14 @@ ** ** @note this is rather a concept draft and left as such for now... don't take this code too literal! ** @todo clarify the relation of config query and query-for-defaults ///////////////TICKET #705 + ** @todo as of 11/2016 the situation is basically the same: this is placeholder code + ** and just implemented enough to keep us going without violating the architecture vision ** ** @see lumiera::Query ** @see mobject::session::DefsManager ** @see asset::StructFactory ** @see config-resolver.hpp specialised setup for the Proc-Layer ** @see fake-configrules.hpp currently used dummy-implementation - ** @see ** */ diff --git a/src/common/config-typed.c b/src/common/config-typed.c index cbfd88c49..b7d38a26d 100644 --- a/src/common/config-typed.c +++ b/src/common/config-typed.c @@ -22,8 +22,11 @@ /** @file config-type.d - ** Implementation: high level typed configuration interfaces. + ** Implementation draft for a configuration system (2008). + ** This file implements high level typed configuration interfaces. ** @note unfinished draft from 2008 + ** @todo as of 2016 this code is unused and + ** likely to be replaced by a different approach. */ #include "include/logging.h" diff --git a/src/common/config-wordlist.c b/src/common/config-wordlist.c index 2bc21f967..2c6a05d0e 100644 --- a/src/common/config-wordlist.c +++ b/src/common/config-wordlist.c @@ -22,7 +22,11 @@ /** @file config-wordlist.c - ** TODO config-wordlist.c + ** Draft for a configuration system (2008). + ** Part of this is the implementation of a word list with + ** search and access functions + ** @todo as of 2016 this code is unused and + ** likely to be replaced by a different approach. */ diff --git a/src/common/config.c b/src/common/config.c index 7d70d255e..b08073356 100644 --- a/src/common/config.c +++ b/src/common/config.c @@ -22,7 +22,9 @@ /** @file config.c - ** TODO config.c + ** Implementation of a draft for application configuration from 2008. + ** @warning since 2012 it is unclear if we retain this approach + ** @todo as of 2016 this code is not used and never was */ diff --git a/src/common/config.h b/src/common/config.h index 0c08eb49e..82b6025ee 100644 --- a/src/common/config.h +++ b/src/common/config.h @@ -33,6 +33,8 @@ ** to revisit the topic when we've gained a better understanding of ** session storage and management of default values and user preferences. ** + ** @todo as of 2016, this code is not in any meaningful use + ** ** @see lumiera::BasicSetup simple start-up configuration ** @see http://lumiera.org/documentation/technical/backend/ConfigLoader.html ConfigLoader draft from 2008 */ diff --git a/src/common/configentry.c b/src/common/configentry.c index 18336d9fe..ca74e083f 100644 --- a/src/common/configentry.c +++ b/src/common/configentry.c @@ -22,7 +22,9 @@ /** @file configentry.c - ** TODO configentry.c + ** Draft for a configuration system (2008). + ** @todo as of 2016 this code is unused and + ** likely to be replaced by a different approach. */ diff --git a/src/common/configentry.h b/src/common/configentry.h index 066119148..8a7eb0682 100644 --- a/src/common/configentry.h +++ b/src/common/configentry.h @@ -22,7 +22,9 @@ /** @file configentry.h - ** TODO configentry.h + ** Draft for a configuration system (2008). + ** @todo as of 2016 this code is unused and + ** likely to be replaced by a different approach. */ diff --git a/src/common/configfacade.cpp b/src/common/configfacade.cpp index cdaaebd0e..ac7500be5 100644 --- a/src/common/configfacade.cpp +++ b/src/common/configfacade.cpp @@ -22,7 +22,20 @@ /** @file configfacade.cpp - ** TODO configfacade.cpp + ** Draft for a facade to access and retrieve configuration values + ** This was created as part of a first draft towards an application + ** wide configuration system. Later (around 2012) it became clear that + ** we can not judge the requirements for such a system yet, so we deferred + ** the topic altogether. Meanwhile, this facade is sporadically used to + ** mark the necessity to retrieve some "parametrisation values". + ** + ** A preliminary implementation is backed by a `setup.ini` file, + ** located relative to the application binary. + ** + ** @todo as of 2016, this seems not to be used much, if at all. + ** The GTK-UI, which in itself is very preliminary, retrieves + ** some values from configuration, most notably the name of + ** the GTK stylesheet (`gtk-lumiera.css` is the default) */ diff --git a/src/common/configitem.c b/src/common/configitem.c index 01850af4d..0fe3cbd6d 100644 --- a/src/common/configitem.c +++ b/src/common/configitem.c @@ -22,7 +22,10 @@ /** @file configitem.c - ** Implementation: create a configitem from a single line of the config file. + ** Implementation draft for a configuration system (2008). + ** Create a configitem from a single line of the config file. + ** @todo as of 2016 this code is unused and + ** likely to be replaced by a different approach. */ diff --git a/src/common/configitem.h b/src/common/configitem.h index 3781dbcd6..dd0784164 100644 --- a/src/common/configitem.h +++ b/src/common/configitem.h @@ -22,7 +22,11 @@ /** @file configitem.h - ** Hierarchy of configuration items. + ** Draft for a configuration system (2008). + ** @todo as of 2016 this code is unused and + ** likely to be replaced by a different approach. + ** + ** # Hierarchy of configuration items. ** configitems form a 3 level hierarchy: ** ** \verbatim diff --git a/src/common/query/config-rules.cpp b/src/common/query/config-rules.cpp index a7a7149df..ac2e6e6aa 100644 --- a/src/common/query/config-rules.cpp +++ b/src/common/query/config-rules.cpp @@ -23,7 +23,8 @@ /** @file config-rules.cpp - ** TODO config-rules.cpp + ** Implementation backend part for a configuration rules / query system. + ** @todo placeholder and mostly not implemented as of 11/2016 */ diff --git a/src/common/query/defs-manager.hpp b/src/common/query/defs-manager.hpp index 16fb2baba..9800f7834 100644 --- a/src/common/query/defs-manager.hpp +++ b/src/common/query/defs-manager.hpp @@ -22,7 +22,72 @@ /** @file defs-manager.hpp - ** TODO defs-manager.hpp + ** Management of defaults and default rules. + ** It is one of the central ideas to shape the behaviour of Lumiera + ** not through hard wired procedures, but rather by the combination of + ** pattern elements driven by rules. A key element within this approach + ** is the notion of an *default*: Whenever some concrete calculation or + ** behaviour needs an additional element as missing link, in order to + ** reach its intrinsic goals, we (the developers) ask ourselves if the + ** for of this additional element can be derived from first principles + ** or if it is already determined by the input set driving the operation. + ** If this is _not_ the case (and the expectation is that most elements + ** are not fully determined), then we _query for an default._ This pattern + ** creates a lot of implicit extension points, which are safe to use, since + ** they are defined on a logical level. We ask for something to fulfil a + ** given contract. + ** + ** Contrast this to a system, which just has arbitrarily built-in flexibility + ** by parametrisation variables: such systems are known to be brittle, since + ** the _parameter values_ are implicitly tied to the behaviour of the operation + ** through _shared knowledge_ of implementation details. It requires both + ** "Druid knowledge" and an overall focus on the implementation mechanics to + ** adjust such parameters. In this respect, a logical query for defaults is + ** quite different, insofar it forces the implementation to respect abstractions + ** on a very fine grained level, and it allows to express the actual defaults + ** by rules which talk the language of the usage context, not the implementation + ** context. The user shall be able to define generic (logical) rules how the + ** Session should behave for the given editing project. And by combination + ** with an additional set of logical consistency rules, a resolution engine + ** can figure out what would be the right _default element_ to use at a + ** given point in the implementation. + ** + ** @note as of 2017, we are far from such a system, but it is of uttermost + ** importance that we build our implementations with this goal in mind + ** + ** # Configuration Query Interface + ** The [Defaults Manager](\ref DefsManager) exposes an interface similar to + ** a database. The intended audience of this interface is the writer of + ** low-level implementation code. This facade interface is meant to create + ** a more familiar front-end to an essentially logic and rules driven + ** configuration system. And, as an additional benefit, it can be implemented + ** just by a glorified table lookup. Which indeed is what we do until the more + ** elaborate rules based system is in place. + ** + ** An implementation process in need for some missing link typically knows the + ** _type of that missing element._ Which means, this type is possibly an abstract + ** type and defines the contract any solution has to fulfil. Thus, the usage context + ** can just demand "give me a suitable XYZ!". In practice, there are several flavours + ** to this interaction, each of which is expressed by a dedicated method on the + ** DefsManager facade interface: + ** - we can just *retrieve* a suitable solution element, no questions asked. + ** - we can *query* for a suitable solution, while limiting the search to what + ** is already known and defined. This entails the possibility that there is + ** no known solution yet. + ** - we can *demand to fabricate* a suitable solution element. Such a call might + ** still deliver something already fabricated, but the emphasis is on the + ** "make it so" demand. + ** - we can *provide and associate* a solution element we created ourselves, + ** to be available from now on, and associated with a given query. Even + ** this call implicates the necessity for the query to be fulfilled by + ** the given element, which, as a consequence includes the possibility + ** of failure. + ** - for sake of completeness, we can also require a specific element to + ** be purged from knowledge + ** + ** @see DefsManager_test + ** @see DefsManagerImpl_test + ** */ diff --git a/src/common/query/defs-registry.hpp b/src/common/query/defs-registry.hpp index a4449d328..f161f2e8a 100644 --- a/src/common/query/defs-registry.hpp +++ b/src/common/query/defs-registry.hpp @@ -31,7 +31,7 @@ ** Basically, this piece of code defines a specialised index / storage table to hold ** Queries-for-default objects. This allows to remember what actually was used as ** "default" solution for some query and to oder possible default solutions. - ** @remarks as of 2012, we're still using a fake implementation of the resolution, + ** @remarks as of 2017, we're still using a fake implementation of the resolution, ** no real resolution engine. While the basic idea of this "defaults registry" ** is likely to stay, the actual order relation and maybe even the components ** to be stored in this registry might be subject to change. diff --git a/src/common/query/query-resolver.cpp b/src/common/query/query-resolver.cpp index 2d974c556..358414a5f 100644 --- a/src/common/query/query-resolver.cpp +++ b/src/common/query/query-resolver.cpp @@ -22,7 +22,14 @@ /** @file query-resolver.cpp - ** TODO query-resolver.cpp + ** implementation of a framework to query and discover elements + ** based on logical rules. This framework builds on the notion of + ** possibly having several QueryResolver facilities to handle various + ** kinds of queries in an uniform way. To reflect that design, the + ** implementation is built round a DispatcherTable to forward requests + ** to concrete entities implementing the QueryResolver interface. The + ** actual query resolution mechanism is thus not part of the framework. + ** */ @@ -102,7 +109,7 @@ namespace lumiera { REQUIRE (!dispatcher_->empty(), "attempt to issue a query without having installed any resolver (yet)"); if (!canHandle (query)) - throw lumiera::error::Invalid ("unable to resolve this kind of query"); ////TICKET #197 + throw lumiera::error::Invalid ("unable to resolve this kind of query"); //////////////////////////////////TICKET #197 return dispatcher_->handle(query); } diff --git a/src/common/query/query-resolver.hpp b/src/common/query/query-resolver.hpp index f7f831c73..3850fb215 100644 --- a/src/common/query/query-resolver.hpp +++ b/src/common/query/query-resolver.hpp @@ -22,7 +22,13 @@ /** @file query-resolver.hpp - ** TODO query-resolver.hpp + ** framework and to resolve logical queries. + ** This header defines a family of interfaces and classes + ** to integrate resolution of logical, rules based queries into generic + ** implementation code. The concrete facility actually to resolve such queries + ** is abstracted away as QueryResolver. A prominent usage example is the session, + ** which allows to query for elements "somewhere within the model" + ** */ diff --git a/src/include/config-facade.h b/src/include/config-facade.h index 6beb6b95a..43dcce424 100644 --- a/src/include/config-facade.h +++ b/src/include/config-facade.h @@ -26,9 +26,17 @@ ** as early as possible. Later, on application main initialisation, the global ** config interface is opened and wrapped for convenient access from C++ code. ** + ** @note This was created as part of a first draft towards an application + ** wide configuration system. Later (around 2012) it became clear that + ** we can not judge the requirements for such a system yet, so we deferred + ** the topic altogether. Meanwhile, this facade is sporadically used to + ** mark the necessity to retrieve some "parametrisation values". + ** @warning as a preliminary solution, the original configuration system draft + ** was detached and replaced by an _ini file solution_ based on lib Boost. + ** ** @todo there ought to be an external Interface for the Config subsystem. ** But the full-blown Config system isn't implemented yet anyway - ** + ** ** @see config.h ** @see lumiera::AppState ** @see main.cpp From f694f9aa2ddc10bcf48c502c550dfa87ebf1f1b2 Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Fri, 4 Nov 2016 22:29:24 +0100 Subject: [PATCH 06/26] Doxygen: fill in file level headlines for further application core services --- src/common/appstate.cpp | 10 +++++-- src/common/appstate.hpp | 2 +- src/common/basic-setup.cpp | 9 ++++++- src/common/basic-setup.hpp | 26 ++++++++++++++++++- src/common/interface-descriptor.h | 6 ++++- src/common/interface.h | 4 +-- src/common/interfaceproxy.cpp | 16 +++++++++++- src/common/option.cpp | 3 ++- src/common/option.hpp | 19 +++++++++++++- src/common/subsys.cpp | 10 ++++++- src/common/subsystem-runner.hpp | 19 +++++++++++++- src/gui/display-interface-proxy.hpp | 1 + src/gui/notification-interface-proxy.hpp | 1 + src/include/interfaceproxy.hpp | 14 +++++----- .../play/dummy-player-interface-proxy.hpp | 1 + 15 files changed, 121 insertions(+), 20 deletions(-) diff --git a/src/common/appstate.cpp b/src/common/appstate.cpp index 1f0a5b0af..80d780c2f 100644 --- a/src/common/appstate.cpp +++ b/src/common/appstate.cpp @@ -1,5 +1,5 @@ /* - AppState - application initialisation and behaviour + AppState - application initialisation and behaviour Copyright (C) Lumiera.org 2008, Hermann Vosseler @@ -22,7 +22,13 @@ /** @file appstate.cpp - ** TODO appstate.cpp + ** Implementation of the _main application object_ of Lumiera. + ** This is a service to manage some _really global_ state and to + ** organise, start and stop the ["Subsystems"](\ref subsys.hpp). + ** The AppState object provides the building blocks for the + ** `main()` function to control the global lifecycle. + ** + ** @see main.cpp */ diff --git a/src/common/appstate.hpp b/src/common/appstate.hpp index b32177576..b4ecd1b1e 100644 --- a/src/common/appstate.hpp +++ b/src/common/appstate.hpp @@ -1,5 +1,5 @@ /* - APPSTATE.hpp - application initialisation and behaviour + APPSTATE.hpp - application initialisation and behaviour Copyright (C) Lumiera.org 2008, Hermann Vosseler diff --git a/src/common/basic-setup.cpp b/src/common/basic-setup.cpp index f56cf256f..16b9e2fe5 100644 --- a/src/common/basic-setup.cpp +++ b/src/common/basic-setup.cpp @@ -22,7 +22,14 @@ /** @file basic-setup.cpp - ** TODO basic-setup.cpp + ** Implementation of self-configuration and bootstrap functionality. + ** This allows the application to "find its parts" at startup. + ** @note as of 2016, BasicSetup::BasicSetup(string) also reads + ** and evaluates a simple `*.ini` file to provide a + ** preliminary mechanism for application configuration. + ** This implementation is based on Boost program options + ** + ** @see searchpath.hpp */ diff --git a/src/common/basic-setup.hpp b/src/common/basic-setup.hpp index e9d4d67c9..c018e2389 100644 --- a/src/common/basic-setup.hpp +++ b/src/common/basic-setup.hpp @@ -22,7 +22,31 @@ /** @file basic-setup.hpp - ** TODO basic-setup.hpp + ** Bootstrap and self-configuration of the application at startup. + ** The class BasicSetup represents the very basic self-configuration + ** of the application at start-up. This bootstrap is based on some + ** conventions for the application to "find its parts". + ** + ** # Motivation: why a bootstrap convention? + ** We want Lumiera to be usable _without the need of a set-up._ + ** Since the application is meant to be used in media production, users + ** often have to work in temporary and varying environments. In such a + ** situation, it is desirable just to "unzip and start" an application + ** bundle. On the other hand, obviously we want to create a nice and + ** proper, FSH compliant application, which can be packaged and installed + ** in a modern Linux distribution as first class citizen. We can fulfil + ** both demands by establishing a convention how the application can + ** discover the very basic parts necessary to start up into the `main()` + ** function and read a setup configuration. This setup configuration + ** in turn supports the definition of _search paths_ -- which then + ** allows us to deliver the application in a bundle structure which + ** both can be run from a single root folder and likewise easily + ** be mapped into FSH compliant installation folders by the + ** packager. + ** + ** @see lumiera::AppState::AppState() + ** @see main.cpp + ** */ diff --git a/src/common/interface-descriptor.h b/src/common/interface-descriptor.h index 68babf6f5..d29e5d565 100644 --- a/src/common/interface-descriptor.h +++ b/src/common/interface-descriptor.h @@ -22,7 +22,11 @@ /** @file interface-descriptor.h - ** TODO interface-descriptor.h + ** A data record to describe interface, interface instances and plug-in + ** instances. It is used by the _interface system_ to register, open + ** and manage global extension points and separation interfaces between + ** the components of the application. + ** */ diff --git a/src/common/interface.h b/src/common/interface.h index 060749d11..b687e4139 100644 --- a/src/common/interface.h +++ b/src/common/interface.h @@ -30,7 +30,7 @@ ** versioned to provide forward and backward compatibility for both source and ** binary deployment of modules. ** - ** \par Overview + ** # Overview ** ** To make an interface available to code so that the code can use the ** interface, the interface needs to be declared and then defined. We provide a @@ -72,7 +72,7 @@ ** ) // Exporting from an interface ** \endcode ** - ** \par Naming and Versioning + ** # Naming and Versioning ** ** Interfaces have unique names and a major and minor version. The name and the major version ** is used to construct a C identifier for the interface, the minor version is implicitly defined diff --git a/src/common/interfaceproxy.cpp b/src/common/interfaceproxy.cpp index d90b5e079..acf7b32e0 100644 --- a/src/common/interfaceproxy.cpp +++ b/src/common/interfaceproxy.cpp @@ -22,7 +22,21 @@ /** @file interfaceproxy.cpp - ** TODO interfaceproxy.cpp + ** Implementation of C++ binding proxies on top of the (plain-C based) + ** interface system. This is an implementation facility within the application core, + ** which allows to embody just an ["interface instance handle"](\ref instancehandle.hpp), + ** in order to get RAII-style registration of interfaces and loading of plug-ins. + ** + ** A *crucial requirement* for this approach to work is, that any relevant interface + ** to be bound and exposed as C++ object needs to set up a concrete specialisation of + ** lumiera::facade::Proxy to drive instantiation of the actual binding proxy. + ** The relevant specialisations _need to be included explicitly_ into this + ** compilation unit! + ** + ** The result of this setup is that clients can just invoke `SomeInterface::facade()` + ** and thus call through proper C++ bindings with type safety and automatic + ** lifecycle management. + ** */ diff --git a/src/common/option.cpp b/src/common/option.cpp index fc37f6107..ce59d986b 100644 --- a/src/common/option.cpp +++ b/src/common/option.cpp @@ -22,7 +22,8 @@ /** @file option.cpp - ** TODO option.cpp + ** Implementation of commandline argument handling, + ** based on lib Boost »program options« */ diff --git a/src/common/option.hpp b/src/common/option.hpp index f010e6635..e03f4e19d 100644 --- a/src/common/option.hpp +++ b/src/common/option.hpp @@ -22,7 +22,24 @@ /** @file option.hpp - ** TODO option.hpp + ** front-end for handling the commandline arguments. + ** Lumiera uses the [Boost program options library] for commandline parsing + ** and handling of a `setup.ini` file. After checking the commandline arguments + ** syntactically, the internal options representation is passed to the various + ** [Subsystems](\ref subsys.hpp) of the application. This mechanism allows + ** individual subsystems to decide if they want and need to start up at all. + ** Obviously, starting a subsystem also pulls up its prerequisites. + ** + ** The idea behind this structure is to allow operating the application in + ** various _alternative modes,_ like starting "headless" (without UI), script + ** driven or as node in a renderfarm network. + ** + ** [Boost program options library] : http://www.boost.org/doc/libs/1_55_0/doc/html/program_options.html + ** + ** @see basic-setup.hpp + ** @see lumiera::AppState + ** @see lumiera::Config + ** */ diff --git a/src/common/subsys.cpp b/src/common/subsys.cpp index 072cb6338..f38df69e5 100644 --- a/src/common/subsys.cpp +++ b/src/common/subsys.cpp @@ -22,7 +22,15 @@ /** @file subsys.cpp - ** TODO subsys.cpp + ** Implementation details of a »subsystem descriptor«. + ** The application is split into various such subsystems, + ** which are prompted by main() to start/stop. + ** + ** @see subsystem-runner.hpp + ** @see lumiera::AppState + ** @see facade.cpp + ** @see main.cpp + ** */ diff --git a/src/common/subsystem-runner.hpp b/src/common/subsystem-runner.hpp index f08c163d7..19a432061 100644 --- a/src/common/subsystem-runner.hpp +++ b/src/common/subsystem-runner.hpp @@ -22,7 +22,24 @@ /** @file subsystem-runner.hpp - ** TODO subsystem-runner.hpp + ** Manage execution of the independend [Subsystems](\ref subsys.hpp) + ** of the Lumiera application. The SubsystemRunner is used by + ** lumiera::AppState::init() for actually "performing" the various subsystems, + ** as defined by their [Subsystem descriptors](\ref lumiera::Subsys). Together + ** these parts define the lifecycle protocol. + ** + ** @remark While this facility is still pretty much the first implementation draft + ** from 2008, it fulfilled our needs to express simple dependencies and to + ** conduct a controlled shutdown in case of fatal problems. The operations + ** protocol implied by this implementation might be somewhat brittle and + ** creates strong ties to implementation details, like the fine points + ** of thread handling and locking. If we ever consider to build an + ** improved subsystem runner, we should care to include the + ** full set of lifecycle callbacks, similar to a + ** two phase commit in databases. + ** + ** @see SubsystemRunner_test + ** */ diff --git a/src/gui/display-interface-proxy.hpp b/src/gui/display-interface-proxy.hpp index ecb7b0e22..9e4d8e041 100644 --- a/src/gui/display-interface-proxy.hpp +++ b/src/gui/display-interface-proxy.hpp @@ -40,6 +40,7 @@ /* ==================== gui::Display ====================================== */ #include "include/display-facade.h" +#include "include/interfaceproxy.hpp" namespace lumiera { diff --git a/src/gui/notification-interface-proxy.hpp b/src/gui/notification-interface-proxy.hpp index 3328b0d68..5a0784726 100644 --- a/src/gui/notification-interface-proxy.hpp +++ b/src/gui/notification-interface-proxy.hpp @@ -39,6 +39,7 @@ /* ==================== GuiNotification =================================== */ #include "include/guinotification-facade.h" +#include "include/interfaceproxy.hpp" namespace gui { diff --git a/src/include/interfaceproxy.hpp b/src/include/interfaceproxy.hpp index 05c6ead6c..78ef4b9ee 100644 --- a/src/include/interfaceproxy.hpp +++ b/src/include/interfaceproxy.hpp @@ -22,7 +22,7 @@ /** @file interfaceproxy.hpp ** Facade Interfaces Lifecycle. Communication between the Layers within Lumiera - ** usually is routed through Layer Separation Interfaces. These are comprised + ** usually is routed through *Layer Separation Interfaces*. These are comprised ** of a Facade interface and a equivalent rendering as C Language interface defined ** with the help of the Interface/Plugin system. But in order to be able to actually ** access a service via this Facade, you need an instance of the interface. @@ -33,12 +33,12 @@ ** Typically there is another subclass of the Facade interfaces sitting "on the other side" ** of the interface barrier and actually implementing the functionality. The template ** facade::Accessor can be thought of as a factory creating such a proxy instance of the - ** facade interface for the client code to use. Typically, an instance of the \em factory + ** facade interface for the client code to use. Typically, an instance of the _factory_ ** is embedded (as a static functor member object) right within the otherwise abstract - ** facade interface, this way allowing the client code to write e.g. \c XYZInterface::facade() - ** to yield a reference to a proxy object implementing \c XYZInterface. + ** facade interface, this way allowing the client code to write e.g. `XYZInterface::facade()` + ** to yield a reference to a proxy object implementing `XYZInterface`. ** - ** Interface Lifecycle + ** # Interface Lifecycle ** ** Instances of an Interface are either directly provided by some facility within the core, ** or they are loaded from a shared module (plugin). In either case this means the interface @@ -63,8 +63,8 @@ ** While client code just includes the interface header (including interfaceproxy.hpp ** in turn), there needs to be an actual implementation of each proxy object located in ** some translation unit. The usual place is interfaceproxy.cpp, which gets linked into - ** \c liblumieracommon.so and contains actual specialisations and literal forwarding - ** code for each individual facade. + ** `liblumieracommon.so` and contains actual specialisations and literal forwarding + ** code _for each individual facade._ ** ** @see interface.h ** @see plugin.h diff --git a/src/proc/play/dummy-player-interface-proxy.hpp b/src/proc/play/dummy-player-interface-proxy.hpp index 1b01e834b..29e00ef53 100644 --- a/src/proc/play/dummy-player-interface-proxy.hpp +++ b/src/proc/play/dummy-player-interface-proxy.hpp @@ -54,6 +54,7 @@ //#include "proc/play/dummy-player-service.hpp" #include "include/dummy-player-facade.h" +#include "include/interfaceproxy.hpp" namespace lumiera { From b258bc9275a0a91bc8bd0ce7ea29fdaac4a4db8c Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Sun, 6 Nov 2016 14:19:14 +0100 Subject: [PATCH 07/26] Doxygen: fill in missing file level headlines for the GUI --- src/common/guifacade.cpp | 7 ++++++- src/gui/ctrl/playback-controller.cpp | 5 ++++- src/gui/dialog/dialog.hpp | 2 +- src/gui/dialog/name-chooser.cpp | 3 ++- src/gui/dialog/name-chooser.hpp | 2 +- src/gui/dialog/preferences-dialog.hpp | 5 ++++- src/gui/dialog/render.cpp | 3 ++- src/gui/dialog/render.hpp | 2 +- src/gui/guifacade.hpp | 2 +- src/gui/model/clip-track.cpp | 4 +++- src/gui/model/clip-track.hpp | 7 ++++--- src/gui/model/clip.cpp | 5 ++++- src/gui/model/clip.hpp | 4 +++- src/gui/model/group-track.cpp | 5 ++++- src/gui/model/group-track.hpp | 6 +++++- src/gui/model/parent-track.cpp | 5 ++++- src/gui/model/parent-track.hpp | 11 +++++++---- src/gui/model/project.cpp | 6 +++++- src/gui/model/project.hpp | 4 +++- src/gui/model/sequence.cpp | 4 +++- src/gui/model/sequence.hpp | 10 ++++++---- src/gui/model/track.cpp | 5 ++++- src/gui/model/track.hpp | 5 ++++- src/gui/output/displayer.cpp | 9 ++++++++- src/gui/output/displayer.hpp | 6 +++++- src/gui/output/gdkdisplayer.cpp | 4 +++- src/gui/output/xvdisplayer.cpp | 7 ++++++- src/gui/output/xvdisplayer.hpp | 6 +++++- src/gui/panel/assets-panel.cpp | 2 +- src/gui/panel/assets-panel.hpp | 8 +++++++- src/gui/panel/panel.cpp | 2 +- src/gui/panel/panel.hpp | 2 +- src/gui/panel/timeline-panel.cpp | 2 +- src/gui/panel/viewer-panel.cpp | 2 +- src/gui/panel/viewer-panel.hpp | 2 +- src/gui/util/cairo-util.cpp | 2 +- src/gui/util/cairo-util.hpp | 3 ++- src/gui/util/rectangle.cpp | 2 +- src/gui/util/rectangle.hpp | 2 +- src/gui/widget/timeline/basic-draw-strategy.hpp | 2 +- src/gui/widget/timeline/draw-strategy.cpp | 3 ++- src/gui/widget/timeline/draw-strategy.hpp | 5 ++++- src/gui/widget/timeline/timeline-arrow-tool.cpp | 2 +- src/gui/widget/timeline/timeline-arrow-tool.hpp | 1 + src/gui/widget/timeline/timeline-body.cpp | 2 +- src/gui/widget/timeline/timeline-body.hpp | 1 + src/gui/widget/timeline/timeline-clip-track.cpp | 2 +- src/gui/widget/timeline/timeline-clip.cpp | 2 +- src/gui/widget/timeline/timeline-clip.hpp | 1 + src/gui/widget/timeline/timeline-entity.cpp | 3 ++- src/gui/widget/timeline/timeline-entity.hpp | 3 ++- src/gui/widget/timeline/timeline-group-track.cpp | 3 ++- src/gui/widget/timeline/timeline-group-track.hpp | 4 +++- src/gui/widget/timeline/timeline-header-container.cpp | 2 +- src/gui/widget/timeline/timeline-header-container.hpp | 5 ++++- src/gui/widget/timeline/timeline-header-widget.cpp | 2 +- src/gui/widget/timeline/timeline-header-widget.hpp | 3 ++- src/gui/widget/timeline/timeline-ibeam-tool.cpp | 2 +- src/gui/widget/timeline/timeline-ibeam-tool.hpp | 1 + src/gui/widget/timeline/timeline-layout-helper.cpp | 3 ++- src/gui/widget/timeline/timeline-layout-helper.hpp | 3 ++- src/gui/widget/timeline/timeline-ruler.cpp | 3 ++- src/gui/widget/timeline/timeline-ruler.hpp | 3 ++- src/gui/widget/timeline/timeline-state.cpp | 3 ++- src/gui/widget/timeline/timeline-state.hpp | 4 +++- src/gui/widget/timeline/timeline-tool.cpp | 3 ++- src/gui/widget/timeline/timeline-tool.hpp | 4 +++- src/gui/widget/timeline/timeline-track.cpp | 4 +++- src/gui/widget/timeline/timeline-track.hpp | 4 +++- src/gui/widget/timeline/timeline-view-window.cpp | 3 ++- src/gui/widget/timeline/timeline-view-window.hpp | 3 ++- src/gui/widget/timeline/timeline-zoom-scale.cpp | 3 ++- src/gui/widget/timeline/timeline-zoom-scale.hpp | 3 ++- 73 files changed, 191 insertions(+), 77 deletions(-) diff --git a/src/common/guifacade.cpp b/src/common/guifacade.cpp index 1f5598c7b..4c4afc6ac 100644 --- a/src/common/guifacade.cpp +++ b/src/common/guifacade.cpp @@ -22,7 +22,12 @@ /** @file guifacade.cpp - ** TODO guifacade.cpp + ** Implementation of the GUI loader. Code generated from this + ** translation unit is linked into the core application, where it implements + ** the [Subsystem descriptor](subsys.hpp) for the _UI Subsystem._ When main() + ** activates and starts this subsystem, an instance of gui::GuiRunner will be + ** created, which causes the Lumiera UI plug-in to be loaded and a new thread + ** to be spawned, which launches the UI and performs the event loop. */ diff --git a/src/gui/ctrl/playback-controller.cpp b/src/gui/ctrl/playback-controller.cpp index 40565a640..c9ba61226 100644 --- a/src/gui/ctrl/playback-controller.cpp +++ b/src/gui/ctrl/playback-controller.cpp @@ -22,7 +22,10 @@ /** @file playback-controller.cpp - ** TODO playback-controller.cpp + ** Implementation parts of PlaybackController. + ** @warning this is preliminary code and will be reworked, once + ** we're able to connect to actual playback processes + ** performed by the render engine. */ diff --git a/src/gui/dialog/dialog.hpp b/src/gui/dialog/dialog.hpp index 89d3c8d1a..4137c167d 100644 --- a/src/gui/dialog/dialog.hpp +++ b/src/gui/dialog/dialog.hpp @@ -22,7 +22,7 @@ /** @file dialog.hpp - ** TODO dialog.hpp + ** Global constants and definitions for dialogs. */ diff --git a/src/gui/dialog/name-chooser.cpp b/src/gui/dialog/name-chooser.cpp index 8fb9d2556..b1015a93e 100644 --- a/src/gui/dialog/name-chooser.cpp +++ b/src/gui/dialog/name-chooser.cpp @@ -22,7 +22,8 @@ /** @file name-chooser.cpp - ** TODO name-chooser.cpp + ** Implementation details of NameChooser, + ** a dialog to enter a name string. */ diff --git a/src/gui/dialog/name-chooser.hpp b/src/gui/dialog/name-chooser.hpp index bbba4a9eb..efb98e5ee 100644 --- a/src/gui/dialog/name-chooser.hpp +++ b/src/gui/dialog/name-chooser.hpp @@ -22,7 +22,7 @@ /** @file name-chooser.hpp - ** TODO name-chooser.hpp + ** Dialog to enter a string name. */ diff --git a/src/gui/dialog/preferences-dialog.hpp b/src/gui/dialog/preferences-dialog.hpp index 6dc45af36..8a859935f 100644 --- a/src/gui/dialog/preferences-dialog.hpp +++ b/src/gui/dialog/preferences-dialog.hpp @@ -22,7 +22,10 @@ /** @file preferences-dialog.hpp - ** TODO preferences-dialog.hpp + ** Dialog to manage application preferences. + ** @todo as of 2016, this is more of a place-holder, since we also + ** do not have decided on the implementation approach for + ** application preferences in general. */ diff --git a/src/gui/dialog/render.cpp b/src/gui/dialog/render.cpp index 227f82ab2..eb81f6d3e 100644 --- a/src/gui/dialog/render.cpp +++ b/src/gui/dialog/render.cpp @@ -22,7 +22,8 @@ /** @file render.cpp - ** TODO render.cpp + ** Implementation of gui:dialog::Render, which is a Dialog + ** to set up a renter process and define output name and format. */ diff --git a/src/gui/dialog/render.hpp b/src/gui/dialog/render.hpp index 5f105b31c..e35d71851 100644 --- a/src/gui/dialog/render.hpp +++ b/src/gui/dialog/render.hpp @@ -21,7 +21,7 @@ */ /** @file render.hpp - ** definition of the render output dialog + ** Dialog to set up a renter process and define output name and format. ** */ diff --git a/src/gui/guifacade.hpp b/src/gui/guifacade.hpp index 5c8b5a31c..e05e5bdc6 100644 --- a/src/gui/guifacade.hpp +++ b/src/gui/guifacade.hpp @@ -25,7 +25,7 @@ ** lower layers of Lumiera. While part of the public interface of the Lumiera GUI, ** the implementation of this facility is part of the core application (and not ** contained within the GUI dynamic module), because it's job is to load and - ** activate this module and to startup the GUI. + ** activate this module as plug-in and to startup the GUI. ** ** @see lumiera::AppState ** @see lumiera::Option diff --git a/src/gui/model/clip-track.cpp b/src/gui/model/clip-track.cpp index dd4bdf086..007522d98 100644 --- a/src/gui/model/clip-track.cpp +++ b/src/gui/model/clip-track.cpp @@ -22,7 +22,9 @@ /** @file clip-track.cpp - ** TODO clip-track.cpp + ** Preliminary UI-model: Implementation of timeline track model object. + ** @warning as of 2016 this UI model is known to be a temporary workaround + ** and will be replaced in entirety by UI-Bus and diff framework. */ #include "clip-track.hpp" diff --git a/src/gui/model/clip-track.hpp b/src/gui/model/clip-track.hpp index 24169a04e..15ac37d47 100644 --- a/src/gui/model/clip-track.hpp +++ b/src/gui/model/clip-track.hpp @@ -21,9 +21,10 @@ */ /** - * @file model/clip-track.hpp - * This file contains the definition of timeline track objects which - * contain clips. + ** @file model/clip-track.hpp + ** Preliminary UI-model: Definition of timeline track objects which contain clips. + ** @warning as of 2016 this UI model is known to be a temporary workaround + ** and will be replaced in entirety by UI-Bus and diff framework. */ diff --git a/src/gui/model/clip.cpp b/src/gui/model/clip.cpp index 59c2fd21f..ee6dead8d 100644 --- a/src/gui/model/clip.cpp +++ b/src/gui/model/clip.cpp @@ -22,7 +22,10 @@ /** @file clip.cpp - ** TODO clip.cpp + ** Preliminary UI-model: implementation of a Clip object as placeholder to + ** base the GUI implementation on. + ** @warning as of 2016 this UI model is known to be a temporary workaround + ** and will be replaced in entirety by UI-Bus and diff framework. */ diff --git a/src/gui/model/clip.hpp b/src/gui/model/clip.hpp index 134680e95..71cd15f2f 100644 --- a/src/gui/model/clip.hpp +++ b/src/gui/model/clip.hpp @@ -21,8 +21,10 @@ */ /** @file model/clip.hpp - ** This file defines a Proxy Clip object to base the GUI implementation on. + ** Preliminary UI-model: a Proxy Clip object to base the GUI implementation on. ** Later this Clip object will be connected to the underlying model in Proc-Layer. + ** @warning as of 2016 this UI model is known to be a temporary workaround + ** and will be replaced in entirety by UI-Bus and diff framework. */ #ifndef GUI_MODEL_CLIP_H diff --git a/src/gui/model/group-track.cpp b/src/gui/model/group-track.cpp index b27e6e6e2..f5fb8415c 100644 --- a/src/gui/model/group-track.cpp +++ b/src/gui/model/group-track.cpp @@ -22,7 +22,10 @@ /** @file group-track.cpp - ** TODO group-track.cpp + ** Preliminary UI-model: Implementation for the group track timeline objects. + ** @warning as of 2016 this UI model is known to be a temporary workaround + ** and will be replaced in entirety by UI-Bus and diff framework. + ** @deprecated the existing timeline implementation will be completely rewritten */ #include "group-track.hpp" diff --git a/src/gui/model/group-track.hpp b/src/gui/model/group-track.hpp index 77ccc9a5e..11185a571 100644 --- a/src/gui/model/group-track.hpp +++ b/src/gui/model/group-track.hpp @@ -21,7 +21,10 @@ */ /** @file widget/timeline/group-track.hpp - ** This file contains the definition of group track timeline objects + ** Preliminary UI-model: Definition of group track timeline objects. + ** @warning as of 2016 this UI model is known to be a temporary workaround + ** and will be replaced in entirety by UI-Bus and diff framework. + ** @deprecated the existing timeline implementation will be completely rewritten */ @@ -36,6 +39,7 @@ namespace model { /** * A class representation of a grouping of tracks. + * @deprecated the existing timeline implementation will be rewritten */ class GroupTrack : public ParentTrack { diff --git a/src/gui/model/parent-track.cpp b/src/gui/model/parent-track.cpp index 2326c96aa..3a7d7c5f2 100644 --- a/src/gui/model/parent-track.cpp +++ b/src/gui/model/parent-track.cpp @@ -22,7 +22,10 @@ /** @file parent-track.cpp - ** TODO parent-track.cpp + ** Preliminary UI-model: Implementation of ParentTrack. + ** @warning as of 2016 this UI model is known to be a temporary workaround + ** and will be replaced in entirety by UI-Bus and diff framework. + ** @deprecated the existing timeline implementation will be completely rewritten */ #include "parent-track.hpp" diff --git a/src/gui/model/parent-track.hpp b/src/gui/model/parent-track.hpp index 12053e321..11610fb48 100644 --- a/src/gui/model/parent-track.hpp +++ b/src/gui/model/parent-track.hpp @@ -20,9 +20,12 @@ */ /** @file parent-track.hpp - ** This file contains the definition of ParentTrack, a class which + ** Preliminary UI-model: Definition of ParentTrack, a class which ** represents a base functionality for tracks and sequences which - ** are also track parents. This class wraps proc layer data + ** are also track parents. This class was intended to wraps proc layer data. + ** @warning as of 2016 this UI model is known to be a temporary workaround + ** and will be replaced in entirety by UI-Bus and diff framework. + ** @deprecated the existing timeline implementation will be completely rewritten */ #ifndef PARENT_TRACK_HPP @@ -35,8 +38,8 @@ namespace gui { namespace model { /** - * ParentTrack is the abstract base class of all tracks that can parent - * children. + * ParentTrack is the abstract base class of all tracks that can parent children. + * @deprecated the existing timeline implementation will be rewritten */ class ParentTrack : public Track, diff --git a/src/gui/model/project.cpp b/src/gui/model/project.cpp index cbe77efcb..d33f02247 100644 --- a/src/gui/model/project.cpp +++ b/src/gui/model/project.cpp @@ -22,7 +22,11 @@ /** @file project.cpp - ** TODO project.cpp + ** Preliminary UI-model: Implementation of Project, a class which + ** stores project data, and wraps proc layer data. + ** @warning as of 2016 this UI model is known to be a temporary workaround + ** and will be replaced in entirety by UI-Bus and diff framework. + ** */ diff --git a/src/gui/model/project.hpp b/src/gui/model/project.hpp index 363c73544..466986aac 100644 --- a/src/gui/model/project.hpp +++ b/src/gui/model/project.hpp @@ -21,8 +21,10 @@ */ /** @file project.hpp - ** This file contains the definition of Project, a class which + ** Preliminary UI-model: Definition of Project, a class which ** stores project data, and wraps proc layer data. + ** @warning as of 2016 this UI model is known to be a temporary workaround + ** and will be replaced in entirety by UI-Bus and diff framework. ** ** @todo this solution was used to build the first outline of the UI. ** It needs to be reshaped into a connector to Proc-Layer ///////////////TICKET #959 diff --git a/src/gui/model/sequence.cpp b/src/gui/model/sequence.cpp index f66be26c5..37ba5c46e 100644 --- a/src/gui/model/sequence.cpp +++ b/src/gui/model/sequence.cpp @@ -22,7 +22,9 @@ /** @file sequence.cpp - ** TODO sequence.cpp + ** Preliminary UI-model: implementation of an editable sequence. + ** @warning as of 2016 this UI model is known to be a temporary workaround + ** and will be replaced in entirety by UI-Bus and diff framework. */ #include "gui/model/sequence.hpp" diff --git a/src/gui/model/sequence.hpp b/src/gui/model/sequence.hpp index aae7873ab..e43209340 100644 --- a/src/gui/model/sequence.hpp +++ b/src/gui/model/sequence.hpp @@ -21,10 +21,12 @@ */ /** @file sequence.hpp - ** The GUI-Model representation of an editable sequence. - ** @todo Currently (1/2014) this is a dummy placeholder, but later on - ** the GUI-Model entities will be connected to the Session model - ** through the use of PlacementRef + ** Preliminary UI-model: representation of an editable sequence. + ** @warning as of 2016 this UI model is known to be a temporary workaround + ** and will be replaced in entirety by UI-Bus and diff framework. + ** + ** @todo Currently (1/2014) this is a dummy placeholder, intention is + ** to connect GUI-Model entities to the Session model eventually. */ diff --git a/src/gui/model/track.cpp b/src/gui/model/track.cpp index d493a0039..ed3190134 100644 --- a/src/gui/model/track.cpp +++ b/src/gui/model/track.cpp @@ -22,7 +22,10 @@ /** @file track.cpp - ** TODO track.cpp + ** Preliminary UI-model: Implementation for the track timeline objects. + ** @warning as of 2016 this UI model is known to be a temporary workaround + ** and will be replaced in entirety by UI-Bus and diff framework. + ** @deprecated the existing timeline implementation will be completely rewritten */ diff --git a/src/gui/model/track.hpp b/src/gui/model/track.hpp index ebe71dab0..62281225c 100644 --- a/src/gui/model/track.hpp +++ b/src/gui/model/track.hpp @@ -20,8 +20,11 @@ */ /** @file track.hpp - ** This file contains the definition of Track, a class which + ** Preliminary UI-model: Definition of Track, a class which ** represents a track, and wraps proc layer data + ** @warning as of 2016 this UI model is known to be a temporary workaround + ** and will be replaced in entirety by UI-Bus and diff framework. + ** @deprecated the existing timeline implementation will be completely rewritten */ diff --git a/src/gui/output/displayer.cpp b/src/gui/output/displayer.cpp index 551fd35f3..d773762bb 100644 --- a/src/gui/output/displayer.cpp +++ b/src/gui/output/displayer.cpp @@ -24,7 +24,14 @@ /** @file displayer.cpp - ** TODO displayer.cpp + ** Implementation of a displayer object, intended for creating + ** a video display in the UI. This class was created as part of + ** an initial draft of the user interface. + ** @warning as of 2016 it is not clear, if this code will be + ** evolved into the actual display facility, or be + ** replaced and rewritten, when we're about to + ** create a functional video display connected + ** to the render engine. */ diff --git a/src/gui/output/displayer.hpp b/src/gui/output/displayer.hpp index 157dc4151..6f02d395c 100644 --- a/src/gui/output/displayer.hpp +++ b/src/gui/output/displayer.hpp @@ -24,7 +24,11 @@ /** @file displayer.hpp ** The Displayer serves as base of all video display implementations - ** + ** @warning as of 2016 it is not clear, if this code will be + ** evolved into the actual display facility, or be + ** replaced and rewritten, when we're about to + ** create a functional video display connected + ** to the render engine. */ diff --git a/src/gui/output/gdkdisplayer.cpp b/src/gui/output/gdkdisplayer.cpp index c088c602f..f27d6f527 100644 --- a/src/gui/output/gdkdisplayer.cpp +++ b/src/gui/output/gdkdisplayer.cpp @@ -24,7 +24,9 @@ /** @file gdkdisplayer.cpp - ** TODO gdkdisplayer.cpp + ** Dysfunctional implementation code, formerly used to + ** create a video display based on GDK + ** @deprecated obsolete since GTK-3 */ diff --git a/src/gui/output/xvdisplayer.cpp b/src/gui/output/xvdisplayer.cpp index 583330c41..b76dc9755 100644 --- a/src/gui/output/xvdisplayer.cpp +++ b/src/gui/output/xvdisplayer.cpp @@ -24,7 +24,12 @@ /** @file xvdisplayer.cpp - ** TODO xvdisplayer.cpp + ** Implementation of video output via XVideo + ** @warning as of 2016 it is not clear, if this code will be + ** evolved into the actual display facility, or be + ** replaced and rewritten, when we're about to + ** create a functional video display connected + ** to the render engine. */ diff --git a/src/gui/output/xvdisplayer.hpp b/src/gui/output/xvdisplayer.hpp index 8e87b4438..3b7af42d8 100644 --- a/src/gui/output/xvdisplayer.hpp +++ b/src/gui/output/xvdisplayer.hpp @@ -25,7 +25,11 @@ /** @file xvdisplayer.hpp ** Implementation of video output via XVideo - ** + ** @warning as of 2016 it is not clear, if this code will be + ** evolved into the actual display facility, or be + ** replaced and rewritten, when we're about to + ** create a functional video display connected + ** to the render engine. ** @see displayer.hpp */ diff --git a/src/gui/panel/assets-panel.cpp b/src/gui/panel/assets-panel.cpp index 1bc90b833..dc363d5d7 100644 --- a/src/gui/panel/assets-panel.cpp +++ b/src/gui/panel/assets-panel.cpp @@ -22,7 +22,7 @@ /** @file assets-panel.cpp - ** TODO assets-panel.cpp + ** Implementation of a (dockable) panel to organise the assets of a project. */ #include "gui/gtk-lumiera.hpp" diff --git a/src/gui/panel/assets-panel.hpp b/src/gui/panel/assets-panel.hpp index 6e0d9945d..9e7afa2d1 100644 --- a/src/gui/panel/assets-panel.hpp +++ b/src/gui/panel/assets-panel.hpp @@ -22,7 +22,13 @@ /** @file assets-panel.hpp - ** TODO assets-panel.hpp + ** A (dockable) panel to organise the assets of a project. + ** Assets are descriptor objects maintained within the Session model. + ** They are used to represent + ** - media and clips + ** - processors, effects etc. + ** - structural elements like timeline, tracks, sequences etc. + ** - metadata descriptors */ diff --git a/src/gui/panel/panel.cpp b/src/gui/panel/panel.cpp index 766e55129..36e3bcc1d 100644 --- a/src/gui/panel/panel.cpp +++ b/src/gui/panel/panel.cpp @@ -22,7 +22,7 @@ /** @file panel.cpp - ** TODO panel.cpp + ** Implementation base for all dockable panels */ diff --git a/src/gui/panel/panel.hpp b/src/gui/panel/panel.hpp index d059c526a..8e8c43509 100644 --- a/src/gui/panel/panel.hpp +++ b/src/gui/panel/panel.hpp @@ -22,7 +22,7 @@ /** @file panel.hpp - ** TODO panel.hpp + ** Base class and interface for all dockable panels */ diff --git a/src/gui/panel/timeline-panel.cpp b/src/gui/panel/timeline-panel.cpp index d7659ad92..97cfb6198 100644 --- a/src/gui/panel/timeline-panel.cpp +++ b/src/gui/panel/timeline-panel.cpp @@ -22,7 +22,7 @@ /** @file timeline-panel.cpp - ** TODO timeline-panel.cpp + ** Implementation of the dockable panel to hold the main timeline display. */ diff --git a/src/gui/panel/viewer-panel.cpp b/src/gui/panel/viewer-panel.cpp index a7dad5ccb..d288483b5 100644 --- a/src/gui/panel/viewer-panel.cpp +++ b/src/gui/panel/viewer-panel.cpp @@ -22,7 +22,7 @@ /** @file viewer-panel.cpp - ** TODO viewer-panel.cpp + ** Implementation of a dockable panel to hold the video viewers */ #include "gui/gtk-lumiera.hpp" diff --git a/src/gui/panel/viewer-panel.hpp b/src/gui/panel/viewer-panel.hpp index 3eed3d0f9..39d002911 100644 --- a/src/gui/panel/viewer-panel.hpp +++ b/src/gui/panel/viewer-panel.hpp @@ -21,7 +21,7 @@ */ /** @file viewer-panel.hpp - ** This file contains the definition of the viewer panel + ** Definition of a dockable panel to hold the video viewers */ diff --git a/src/gui/util/cairo-util.cpp b/src/gui/util/cairo-util.cpp index 936c2dec8..4165c6317 100644 --- a/src/gui/util/cairo-util.cpp +++ b/src/gui/util/cairo-util.cpp @@ -22,7 +22,7 @@ /** @file cairo-util.cpp - ** TODO cairo-util.cpp + ** Implementation of helper functions to support working with lib Cairo */ diff --git a/src/gui/util/cairo-util.hpp b/src/gui/util/cairo-util.hpp index a9702a942..788c5bc06 100644 --- a/src/gui/util/cairo-util.hpp +++ b/src/gui/util/cairo-util.hpp @@ -22,7 +22,8 @@ /** @file cairo-util.hpp - ** TODO cairo-util.hpp + ** Utility functions for working with elements from the Cairo + ** vector drawing library. */ #include diff --git a/src/gui/util/rectangle.cpp b/src/gui/util/rectangle.cpp index e5b0d4ca6..9a1dfcf0f 100644 --- a/src/gui/util/rectangle.cpp +++ b/src/gui/util/rectangle.cpp @@ -22,7 +22,7 @@ /** @file rectangle.cpp - ** TODO rectangle.cpp + ** Implementation of functions to work with rectangular screen ranges */ #include "gui/util/rectangle.hpp" diff --git a/src/gui/util/rectangle.hpp b/src/gui/util/rectangle.hpp index 29b0e79e9..3fd168612 100644 --- a/src/gui/util/rectangle.hpp +++ b/src/gui/util/rectangle.hpp @@ -22,7 +22,7 @@ /** @file rectangle.hpp - ** TODO rectangle.hpp + ** Helper functions to work with rectangular screen ranges */ diff --git a/src/gui/widget/timeline/basic-draw-strategy.hpp b/src/gui/widget/timeline/basic-draw-strategy.hpp index 58ef4f185..571cf1b26 100644 --- a/src/gui/widget/timeline/basic-draw-strategy.hpp +++ b/src/gui/widget/timeline/basic-draw-strategy.hpp @@ -22,7 +22,7 @@ /** @file basic-draw-strategy.hpp - ** TODO basic-draw-strategy.hpp + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/draw-strategy.cpp b/src/gui/widget/timeline/draw-strategy.cpp index 8932520d0..b0730989c 100644 --- a/src/gui/widget/timeline/draw-strategy.cpp +++ b/src/gui/widget/timeline/draw-strategy.cpp @@ -22,7 +22,8 @@ /** @file draw-strategy.cpp - ** TODO draw-strategy.cpp + ** @deprecated very likely to be completely rewritten. + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/draw-strategy.hpp b/src/gui/widget/timeline/draw-strategy.hpp index 4f1ef7201..2fe308d5e 100644 --- a/src/gui/widget/timeline/draw-strategy.hpp +++ b/src/gui/widget/timeline/draw-strategy.hpp @@ -22,7 +22,10 @@ /** @file draw-strategy.hpp - ** TODO draw-strategy.hpp + ** Strategy interface for drawing timeline entities. This is part of the + ** first implementation draft of the timeline display. + ** @deprecated very likely to be completely rewritten. + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-arrow-tool.cpp b/src/gui/widget/timeline/timeline-arrow-tool.cpp index b00953bed..a64cff2fe 100644 --- a/src/gui/widget/timeline/timeline-arrow-tool.cpp +++ b/src/gui/widget/timeline/timeline-arrow-tool.cpp @@ -22,7 +22,7 @@ /** @file timeline-arrow-tool.cpp - ** TODO timeline-arrow-tool.cpp + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-arrow-tool.hpp b/src/gui/widget/timeline/timeline-arrow-tool.hpp index 5bbfefaaf..cc95695d9 100644 --- a/src/gui/widget/timeline/timeline-arrow-tool.hpp +++ b/src/gui/widget/timeline/timeline-arrow-tool.hpp @@ -22,6 +22,7 @@ /** @file timeline-arrow-tool.hpp ** This file contains the definition of the arrow tool class + ** @warning as of 2016 the entire timeline display is planned to be reworked */ #ifndef GUI_WIDGET_TIMELINE_ARROW_TOOL_H diff --git a/src/gui/widget/timeline/timeline-body.cpp b/src/gui/widget/timeline/timeline-body.cpp index cb5881d72..c9280a6aa 100644 --- a/src/gui/widget/timeline/timeline-body.cpp +++ b/src/gui/widget/timeline/timeline-body.cpp @@ -22,7 +22,7 @@ /** @file timeline-body.cpp - ** TODO timeline-body.cpp + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-body.hpp b/src/gui/widget/timeline/timeline-body.hpp index f31380f0d..99f08500a 100644 --- a/src/gui/widget/timeline/timeline-body.hpp +++ b/src/gui/widget/timeline/timeline-body.hpp @@ -22,6 +22,7 @@ /** @file timeline-body.hpp ** This file contains the definition of timeline body widget + ** @warning as of 2016 the entire timeline display is planned to be reworked */ #ifndef GUI_WIDGET_TIMELINE_BODY_H diff --git a/src/gui/widget/timeline/timeline-clip-track.cpp b/src/gui/widget/timeline/timeline-clip-track.cpp index 220b0d7f4..c21994131 100644 --- a/src/gui/widget/timeline/timeline-clip-track.cpp +++ b/src/gui/widget/timeline/timeline-clip-track.cpp @@ -22,7 +22,7 @@ /** @file timeline-clip-track.cpp - ** TODO timeline-clip-track.cpp + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-clip.cpp b/src/gui/widget/timeline/timeline-clip.cpp index 2d557b4bd..38ee1339a 100644 --- a/src/gui/widget/timeline/timeline-clip.cpp +++ b/src/gui/widget/timeline/timeline-clip.cpp @@ -22,7 +22,7 @@ /** @file timeline-clip.cpp - ** TODO timeline-clip.cpp + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-clip.hpp b/src/gui/widget/timeline/timeline-clip.hpp index 4a03a8c77..a62639f12 100644 --- a/src/gui/widget/timeline/timeline-clip.hpp +++ b/src/gui/widget/timeline/timeline-clip.hpp @@ -22,6 +22,7 @@ /** @file timeline-clip.hpp ** Representation of a clip on the timeline + ** @warning as of 2016 the entire timeline display is planned to be reworked */ #ifndef GUI_WIDGET_TIMELINE_CLIP_H diff --git a/src/gui/widget/timeline/timeline-entity.cpp b/src/gui/widget/timeline/timeline-entity.cpp index 73b865746..da3d4086f 100644 --- a/src/gui/widget/timeline/timeline-entity.cpp +++ b/src/gui/widget/timeline/timeline-entity.cpp @@ -22,7 +22,8 @@ /** @file timeline-entity.cpp - ** TODO timeline-entity.cpp + ** Implementation of a generic element to be placed onto the timeline + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-entity.hpp b/src/gui/widget/timeline/timeline-entity.hpp index 4abcea59e..381962f37 100644 --- a/src/gui/widget/timeline/timeline-entity.hpp +++ b/src/gui/widget/timeline/timeline-entity.hpp @@ -22,7 +22,8 @@ /** @file timeline-entity.hpp - ** any UI element that can be placed on the timeline. + ** Any UI element that can be placed on the timeline. + ** @warning as of 2016 the entire timeline display is planned to be reworked */ #ifndef GUI_WIDGET_TIMELINE_ENTITY_H diff --git a/src/gui/widget/timeline/timeline-group-track.cpp b/src/gui/widget/timeline/timeline-group-track.cpp index e8534cd69..ceed16d1d 100644 --- a/src/gui/widget/timeline/timeline-group-track.cpp +++ b/src/gui/widget/timeline/timeline-group-track.cpp @@ -22,7 +22,8 @@ /** @file timeline-group-track.cpp - ** TODO timeline-group-track.cpp + ** @deprecated to be replaced by a different implementation approach + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-group-track.hpp b/src/gui/widget/timeline/timeline-group-track.hpp index 882bdac52..6120116f6 100644 --- a/src/gui/widget/timeline/timeline-group-track.hpp +++ b/src/gui/widget/timeline/timeline-group-track.hpp @@ -22,7 +22,9 @@ /** @file timeline-group-track.hpp - ** TODO timeline-group-track.hpp + ** Preliminary implementation of a group track within the timeline display + ** @deprecated to be replaced by a different implementation approach + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-header-container.cpp b/src/gui/widget/timeline/timeline-header-container.cpp index 5818f56d5..95bb2ca8c 100644 --- a/src/gui/widget/timeline/timeline-header-container.cpp +++ b/src/gui/widget/timeline/timeline-header-container.cpp @@ -22,7 +22,7 @@ /** @file timeline-header-container.cpp - ** TODO timeline-header-container.cpp + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-header-container.hpp b/src/gui/widget/timeline/timeline-header-container.hpp index 60403f4a9..84ee305f6 100644 --- a/src/gui/widget/timeline/timeline-header-container.hpp +++ b/src/gui/widget/timeline/timeline-header-container.hpp @@ -22,7 +22,10 @@ /** @file timeline-header-container.hpp - ** TODO timeline-header-container.hpp + ** A container to hold the header area of the timeline display. + ** Most notably this was used to create a first version of the patchbay + ** and control areas for the tracks. Very likely to be completely rewritten. + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-header-widget.cpp b/src/gui/widget/timeline/timeline-header-widget.cpp index 877184899..b6cee96f1 100644 --- a/src/gui/widget/timeline/timeline-header-widget.cpp +++ b/src/gui/widget/timeline/timeline-header-widget.cpp @@ -22,7 +22,7 @@ /** @file timeline-header-widget.cpp - ** TODO timeline-header-widget.cpp + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-header-widget.hpp b/src/gui/widget/timeline/timeline-header-widget.hpp index 543fce7ca..ed4bbecda 100644 --- a/src/gui/widget/timeline/timeline-header-widget.hpp +++ b/src/gui/widget/timeline/timeline-header-widget.hpp @@ -22,7 +22,8 @@ /** @file timeline-header-widget.hpp - ** TODO timeline-header-widget.hpp + ** Widget to generate the timeline header + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-ibeam-tool.cpp b/src/gui/widget/timeline/timeline-ibeam-tool.cpp index 1002a5a2b..20f15a604 100644 --- a/src/gui/widget/timeline/timeline-ibeam-tool.cpp +++ b/src/gui/widget/timeline/timeline-ibeam-tool.cpp @@ -22,7 +22,7 @@ /** @file timeline-ibeam-tool.cpp - ** TODO timeline-ibeam-tool.cpp + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-ibeam-tool.hpp b/src/gui/widget/timeline/timeline-ibeam-tool.hpp index 95fec042b..f35778cd4 100644 --- a/src/gui/widget/timeline/timeline-ibeam-tool.hpp +++ b/src/gui/widget/timeline/timeline-ibeam-tool.hpp @@ -23,6 +23,7 @@ /** @file timeline-ibeam-tool.hpp ** A tool to select ranges in the timeline + ** @warning as of 2016 the entire timeline display is planned to be reworked */ #ifndef GUI_WIDGET_TIMELINE_IBEAM_TOOL_H diff --git a/src/gui/widget/timeline/timeline-layout-helper.cpp b/src/gui/widget/timeline/timeline-layout-helper.cpp index c6628709e..688a1f668 100644 --- a/src/gui/widget/timeline/timeline-layout-helper.cpp +++ b/src/gui/widget/timeline/timeline-layout-helper.cpp @@ -22,7 +22,8 @@ /** @file timeline-layout-helper.cpp - ** TODO timeline-layout-helper.cpp + ** Preliminary implementation of Timeline presentation, layout helper. + ** @deprecated as of 2016 this class will become obsolete and replaced by a different implementation approach */ diff --git a/src/gui/widget/timeline/timeline-layout-helper.hpp b/src/gui/widget/timeline/timeline-layout-helper.hpp index a7fcce429..1516f1f9e 100644 --- a/src/gui/widget/timeline/timeline-layout-helper.hpp +++ b/src/gui/widget/timeline/timeline-layout-helper.hpp @@ -20,8 +20,9 @@ */ /** @file timeline-layout-helper.cpp - ** This file contains the definition of the layout helper class + ** Preliminary implementation of Timeline presentation, layout helper. ** @todo this class should be thoroughly reworked; it seems to be kind of a "god class" ////////TODO 5/2015 + ** @deprecated as of 2016 this class will become obsolete and replaced by a different implementation approach */ diff --git a/src/gui/widget/timeline/timeline-ruler.cpp b/src/gui/widget/timeline/timeline-ruler.cpp index 58b88d833..a8dafacf4 100644 --- a/src/gui/widget/timeline/timeline-ruler.cpp +++ b/src/gui/widget/timeline/timeline-ruler.cpp @@ -22,7 +22,8 @@ /** @file timeline-ruler.cpp - ** TODO timeline-ruler.cpp + ** The ruler at the top of the timeline display to represent the time axis. + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-ruler.hpp b/src/gui/widget/timeline/timeline-ruler.hpp index 597544772..a90ad087b 100644 --- a/src/gui/widget/timeline/timeline-ruler.hpp +++ b/src/gui/widget/timeline/timeline-ruler.hpp @@ -22,7 +22,8 @@ /** @file timeline-ruler.hpp - ** TODO timeline-ruler.hpp + ** The ruler at the top of the timeline display to represent the time axis. + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-state.cpp b/src/gui/widget/timeline/timeline-state.cpp index c606b34b2..b8b088638 100644 --- a/src/gui/widget/timeline/timeline-state.cpp +++ b/src/gui/widget/timeline/timeline-state.cpp @@ -22,7 +22,8 @@ /** @file timeline-state.cpp - ** TODO timeline-state.cpp + ** Implementation of presentation state for the first draft of the timeline display. + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-state.hpp b/src/gui/widget/timeline/timeline-state.hpp index 8766d344c..0a8b4ff81 100644 --- a/src/gui/widget/timeline/timeline-state.hpp +++ b/src/gui/widget/timeline/timeline-state.hpp @@ -22,7 +22,9 @@ /** @file timeline-state.hpp - ** TODO timeline-state.hpp + ** Presentation state for the first draft of the timeline display. Very likely + ** to be replaced by a complete rewrite. + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-tool.cpp b/src/gui/widget/timeline/timeline-tool.cpp index 03d1baeda..ffc4d4b7b 100644 --- a/src/gui/widget/timeline/timeline-tool.cpp +++ b/src/gui/widget/timeline/timeline-tool.cpp @@ -22,7 +22,8 @@ /** @file timeline-tool.cpp - ** TODO timeline-tool.cpp + ** Tools and working modes for selections in the timeline. + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-tool.hpp b/src/gui/widget/timeline/timeline-tool.hpp index ade34456b..d5cccc785 100644 --- a/src/gui/widget/timeline/timeline-tool.hpp +++ b/src/gui/widget/timeline/timeline-tool.hpp @@ -22,7 +22,9 @@ /** @file timeline-tool.hpp - ** TODO timeline-tool.hpp + ** Tools and working modes for selections in the timeline. Most notably + ** the Arrow tool for object selection and the I-Beam tool for range selection. + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-track.cpp b/src/gui/widget/timeline/timeline-track.cpp index 125d9533c..6147592a2 100644 --- a/src/gui/widget/timeline/timeline-track.cpp +++ b/src/gui/widget/timeline/timeline-track.cpp @@ -22,7 +22,9 @@ /** @file timeline-track.cpp - ** TODO timeline-track.cpp + ** A group track in the first draft version of the timeline display. + ** @todo as of 2016 this is about to be replaced by a new implementation approach + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-track.hpp b/src/gui/widget/timeline/timeline-track.hpp index 47757c989..25b27968b 100644 --- a/src/gui/widget/timeline/timeline-track.hpp +++ b/src/gui/widget/timeline/timeline-track.hpp @@ -22,7 +22,9 @@ /** @file timeline-track.hpp - ** TODO timeline-track.hpp + ** A group track in the first draft version of the timeline display. + ** @todo as of 2016 this is about to be replaced by a new implementation approach + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-view-window.cpp b/src/gui/widget/timeline/timeline-view-window.cpp index beb99bb37..b3ae76e81 100644 --- a/src/gui/widget/timeline/timeline-view-window.cpp +++ b/src/gui/widget/timeline/timeline-view-window.cpp @@ -22,7 +22,8 @@ /** @file timeline-view-window.cpp - ** TODO timeline-view-window.cpp + ** Implementation of the timeline window, which holds the main timeline display. + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-view-window.hpp b/src/gui/widget/timeline/timeline-view-window.hpp index d5641b7db..19405279c 100644 --- a/src/gui/widget/timeline/timeline-view-window.hpp +++ b/src/gui/widget/timeline/timeline-view-window.hpp @@ -22,7 +22,8 @@ /** @file timeline-view-window.hpp - ** TODO timeline-view-window.hpp + ** Helper to manage the timeline window, which holds the main timeline display. + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-zoom-scale.cpp b/src/gui/widget/timeline/timeline-zoom-scale.cpp index 4cdc9252e..94e8a0945 100644 --- a/src/gui/widget/timeline/timeline-zoom-scale.cpp +++ b/src/gui/widget/timeline/timeline-zoom-scale.cpp @@ -22,7 +22,8 @@ /** @file timeline-zoom-scale.cpp - ** TODO timeline-zoom-scale.cpp + ** Widget to control timeline zoom scale + ** @warning as of 2016 the entire timeline display is planned to be reworked */ diff --git a/src/gui/widget/timeline/timeline-zoom-scale.hpp b/src/gui/widget/timeline/timeline-zoom-scale.hpp index d5bd87270..574fd0493 100644 --- a/src/gui/widget/timeline/timeline-zoom-scale.hpp +++ b/src/gui/widget/timeline/timeline-zoom-scale.hpp @@ -22,7 +22,8 @@ /** @file timeline-zoom-scale.hpp - ** TODO timeline-zoom-scale.hpp + ** Widget to control timeline zoom scale + ** @warning as of 2016 the entire timeline display is planned to be reworked */ From 311ed218cb51f2aa8c4ac4c0c018566acef31f23 Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Sun, 6 Nov 2016 14:38:12 +0100 Subject: [PATCH 08/26] Doxygen: fill in missing file level headlines for the GUI (2) --- src/gui/display-service.cpp | 4 +++- src/gui/display-service.hpp | 2 +- src/gui/gtk-lumiera.cpp | 1 - src/gui/notification-service.cpp | 2 +- src/gui/ui-bus.cpp | 1 - src/gui/widget/button-bar.cpp | 2 +- src/gui/widget/button-bar.hpp | 2 +- src/gui/widget/menu-button.cpp | 2 +- src/gui/widget/menu-button.hpp | 2 +- src/gui/widget/mini-button.hpp | 2 +- src/gui/widget/panel-bar.cpp | 3 ++- src/gui/widget/timecode-widget.cpp | 3 ++- src/gui/widget/timecode-widget.hpp | 7 +++++-- src/gui/widget/timeline-widget.cpp | 2 +- src/gui/widget/video-display-widget.cpp | 2 +- src/gui/widget/video-display-widget.hpp | 2 +- src/gui/window-manager.cpp | 1 - src/gui/workspace/actions.cpp | 3 ++- src/gui/workspace/panel-manager.cpp | 3 ++- src/gui/workspace/workspace-window.cpp | 2 +- src/include/dummy-player-facade.h | 1 - src/include/play-facade.h | 2 +- 22 files changed, 28 insertions(+), 23 deletions(-) diff --git a/src/gui/display-service.cpp b/src/gui/display-service.cpp index 7efe02482..4bfadbb60 100644 --- a/src/gui/display-service.cpp +++ b/src/gui/display-service.cpp @@ -22,7 +22,9 @@ /** @file display-service.cpp - ** TODO display-service.cpp + ** Implementation of _Displayer Service,_ exposed as a public interface. + ** This service allows to set up _display slots,_ which can be handed over + ** to client code in the course of the play process for outputting frames. */ diff --git a/src/gui/display-service.hpp b/src/gui/display-service.hpp index 78463d1c3..e25446432 100644 --- a/src/gui/display-service.hpp +++ b/src/gui/display-service.hpp @@ -116,7 +116,7 @@ namespace gui { * the Lumiera Interface/Plugin system and creates * a forwarding proxy within the application core to * route calls through this interface. - * \par + * * In addition to the Display interface, this class * implements an additional service for the GUI, * allowing actually to set up display slots, which diff --git a/src/gui/gtk-lumiera.cpp b/src/gui/gtk-lumiera.cpp index a4b0cd1e3..7097755c9 100644 --- a/src/gui/gtk-lumiera.cpp +++ b/src/gui/gtk-lumiera.cpp @@ -22,7 +22,6 @@ /** @file gtk-lumiera.cpp - ** TODO gtk-lumiera.cpp */ diff --git a/src/gui/notification-service.cpp b/src/gui/notification-service.cpp index ce73cf52b..b8ab0a15b 100644 --- a/src/gui/notification-service.cpp +++ b/src/gui/notification-service.cpp @@ -22,7 +22,7 @@ /** @file notification-service.cpp - ** TODO notification-service.cpp + ** @todo write documentation for the notification service */ diff --git a/src/gui/ui-bus.cpp b/src/gui/ui-bus.cpp index d22dc2a27..3f93c8f70 100644 --- a/src/gui/ui-bus.cpp +++ b/src/gui/ui-bus.cpp @@ -23,7 +23,6 @@ /** @file ui-bus.cpp - ** TODO ui-bus.cpp */ diff --git a/src/gui/widget/button-bar.cpp b/src/gui/widget/button-bar.cpp index 447814917..2ac8b1195 100644 --- a/src/gui/widget/button-bar.cpp +++ b/src/gui/widget/button-bar.cpp @@ -22,7 +22,7 @@ /** @file button-bar.cpp - ** TODO button-bar.cpp + ** Implementation of a toolbar with buttons for use in dialogs. */ diff --git a/src/gui/widget/button-bar.hpp b/src/gui/widget/button-bar.hpp index 51ff650ea..b83f0e486 100644 --- a/src/gui/widget/button-bar.hpp +++ b/src/gui/widget/button-bar.hpp @@ -22,7 +22,7 @@ /** @file button-bar.hpp - ** TODO button-bar.hpp + ** A toolbar widget for use in dialogs. */ diff --git a/src/gui/widget/menu-button.cpp b/src/gui/widget/menu-button.cpp index 9884cf7a7..bdc856e8b 100644 --- a/src/gui/widget/menu-button.cpp +++ b/src/gui/widget/menu-button.cpp @@ -22,7 +22,7 @@ /** @file menu-button.cpp - ** TODO menu-button.cpp + ** Implementation of the MenuButton widget, to display a menu when clicked. */ diff --git a/src/gui/widget/menu-button.hpp b/src/gui/widget/menu-button.hpp index e738c5082..8e8399b98 100644 --- a/src/gui/widget/menu-button.hpp +++ b/src/gui/widget/menu-button.hpp @@ -22,7 +22,7 @@ /** @file menu-button.hpp - ** TODO menu-button.hpp + ** A button widget that displays a menu when clicked. */ diff --git a/src/gui/widget/mini-button.hpp b/src/gui/widget/mini-button.hpp index a7ca68490..6ddcbe36b 100644 --- a/src/gui/widget/mini-button.hpp +++ b/src/gui/widget/mini-button.hpp @@ -22,7 +22,7 @@ /** @file mini-button.hpp - ** TODO mini-button.hpp + ** Adapter to wrap button widgets intended to serve as tool buttons */ diff --git a/src/gui/widget/panel-bar.cpp b/src/gui/widget/panel-bar.cpp index ed33092c3..48bfa8943 100644 --- a/src/gui/widget/panel-bar.cpp +++ b/src/gui/widget/panel-bar.cpp @@ -22,7 +22,8 @@ /** @file panel-bar.cpp - ** TODO panel-bar.cpp + ** Implementation of a custom container widget to place toolbar buttons + ** into the active docking header area of GDL docking panels. */ diff --git a/src/gui/widget/timecode-widget.cpp b/src/gui/widget/timecode-widget.cpp index 7108e11f1..1c9726170 100644 --- a/src/gui/widget/timecode-widget.cpp +++ b/src/gui/widget/timecode-widget.cpp @@ -25,7 +25,8 @@ /** @file timecode-widget.cpp - ** TODO timecode-widget.cpp + ** Widget for timecode display and input. + ** Ported and adapted from the Ardour DAW */ diff --git a/src/gui/widget/timecode-widget.hpp b/src/gui/widget/timecode-widget.hpp index 87792dcdf..3ff2fefe6 100644 --- a/src/gui/widget/timecode-widget.hpp +++ b/src/gui/widget/timecode-widget.hpp @@ -25,7 +25,10 @@ /** @file timecode-widget.hpp - ** TODO timecode-widget.hpp + ** Widget for timecode display and input. + ** Ported and adapted from the Ardour DAW. + ** @todo needs extensive rework to get smooth integration + ** with Lumiera's timecode handling functions */ @@ -55,7 +58,7 @@ namespace widget { /** - * Widget for timecode imput and display. + * Widget for timecode input and display. * Adapted implementation from the Ardour DAW */ class TimeCode diff --git a/src/gui/widget/timeline-widget.cpp b/src/gui/widget/timeline-widget.cpp index 05ffd7990..672feecbb 100644 --- a/src/gui/widget/timeline-widget.cpp +++ b/src/gui/widget/timeline-widget.cpp @@ -22,7 +22,7 @@ /** @file timeline-widget.cpp - ** TODO timeline-widget.cpp + ** @deprecated timecode display is about to be rewritten as of 11/2016 */ diff --git a/src/gui/widget/video-display-widget.cpp b/src/gui/widget/video-display-widget.cpp index 94251b9b0..482ca54a9 100644 --- a/src/gui/widget/video-display-widget.cpp +++ b/src/gui/widget/video-display-widget.cpp @@ -22,7 +22,7 @@ /** @file video-display-widget.cpp - ** TODO video-display-widget.cpp + ** Implementation of video display, embedded into the UI. */ diff --git a/src/gui/widget/video-display-widget.hpp b/src/gui/widget/video-display-widget.hpp index 060db075f..07a3ac8ed 100644 --- a/src/gui/widget/video-display-widget.hpp +++ b/src/gui/widget/video-display-widget.hpp @@ -22,7 +22,7 @@ /** @file video-display-widget.hpp - ** TODO video-display-widget.hpp + ** Widget to create a video display embedded into the UI */ diff --git a/src/gui/window-manager.cpp b/src/gui/window-manager.cpp index 28fd61708..8992501d1 100644 --- a/src/gui/window-manager.cpp +++ b/src/gui/window-manager.cpp @@ -22,7 +22,6 @@ /** @file window-manager.cpp - ** TODO window-manager.cpp */ diff --git a/src/gui/workspace/actions.cpp b/src/gui/workspace/actions.cpp index ddbecf1ef..00461031a 100644 --- a/src/gui/workspace/actions.cpp +++ b/src/gui/workspace/actions.cpp @@ -22,7 +22,8 @@ /** @file actions.cpp - ** TODO actions.cpp + ** Implementation of support functionality to register and manage + ** user actions and command bindings */ diff --git a/src/gui/workspace/panel-manager.cpp b/src/gui/workspace/panel-manager.cpp index 1e48b6057..09a7d12c8 100644 --- a/src/gui/workspace/panel-manager.cpp +++ b/src/gui/workspace/panel-manager.cpp @@ -22,7 +22,8 @@ /** @file panel-manager.cpp - ** TODO panel-manager.cpp + ** Implementation of dockable UI panels, implemented with the + ** help of lib GDL (»Gnome Docking Libraray«, formerly aka »Gnome Design Library«) */ diff --git a/src/gui/workspace/workspace-window.cpp b/src/gui/workspace/workspace-window.cpp index a9ece083e..a8a607aef 100644 --- a/src/gui/workspace/workspace-window.cpp +++ b/src/gui/workspace/workspace-window.cpp @@ -22,7 +22,7 @@ /** @file workspace-window.cpp - ** TODO workspace-window.cpp + ** Implementation of base functionality for workspace windows. */ #include "gui/gtk-lumiera.hpp" diff --git a/src/include/dummy-player-facade.h b/src/include/dummy-player-facade.h index 86aa55cd7..6a11672d4 100644 --- a/src/include/dummy-player-facade.h +++ b/src/include/dummy-player-facade.h @@ -22,7 +22,6 @@ /** @file dummy-player-facade.h - ** TODO dummy-player-facade.h */ diff --git a/src/include/play-facade.h b/src/include/play-facade.h index 0fc39066a..ecfc536a7 100644 --- a/src/include/play-facade.h +++ b/src/include/play-facade.h @@ -22,7 +22,7 @@ /** @file play-facade.h - ** TODO play-facade.h + ** Public access point to the _playback service_ provided by the »play-out subsystem« */ From a3a245ec19844a7109adf3bf1531a7a6b00771c7 Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Mon, 7 Nov 2016 15:39:13 +0100 Subject: [PATCH 09/26] Doxygen: fill in missing file level headlines for the Library (metaprogramming) --- src/lib/idi/genfunc.cpp | 2 +- src/lib/idi/genfunc.hpp | 2 +- src/lib/meta/maybe-compare.hpp | 2 +- src/lib/meta/no-instance.hpp | 17 +++++++++++++++-- src/lib/meta/size-trait.hpp | 21 ++++++++++++++++++++- src/lib/meta/trait-special.hpp | 10 +++++++++- 6 files changed, 47 insertions(+), 7 deletions(-) diff --git a/src/lib/idi/genfunc.cpp b/src/lib/idi/genfunc.cpp index 9e4bce312..c06c1c2ff 100644 --- a/src/lib/idi/genfunc.cpp +++ b/src/lib/idi/genfunc.cpp @@ -22,7 +22,7 @@ /** @file genfunc.cpp - ** TODO genfunc.cpp + ** Implementation of generic functions to build identification schemes. */ diff --git a/src/lib/idi/genfunc.hpp b/src/lib/idi/genfunc.hpp index d4678bb5d..97872eba2 100644 --- a/src/lib/idi/genfunc.hpp +++ b/src/lib/idi/genfunc.hpp @@ -22,7 +22,7 @@ /** @file genfunc.hpp - ** Generic function to build identification schemes. + ** Generic functions to build identification schemes. ** These template functions are meant as common extension point. ** The purpose is to streamline and disentangle the various identification schemes ** in use at various places within Lumiera. We strive to cover all the common basic diff --git a/src/lib/meta/maybe-compare.hpp b/src/lib/meta/maybe-compare.hpp index ef1d14b49..6be093953 100644 --- a/src/lib/meta/maybe-compare.hpp +++ b/src/lib/meta/maybe-compare.hpp @@ -22,7 +22,7 @@ /** @file maybe-compare.hpp - ** TODO maybe-compare.hpp + ** helpers for fail-safe invocation of comparison operations from generic code. */ diff --git a/src/lib/meta/no-instance.hpp b/src/lib/meta/no-instance.hpp index 5290bf480..800bed568 100644 --- a/src/lib/meta/no-instance.hpp +++ b/src/lib/meta/no-instance.hpp @@ -22,7 +22,20 @@ /** @file no-instance.hpp - ** TODO no-instance.hpp + ** Metaprogramming helper to prevent an entity to be ever instantiated at runtime. + ** For Template Metaprogramming, we often define classes for the sole purpose of + ** forming a distinct type. Such helper types are established during compilation + ** and typically trigger the instantiation of further types from templates, while + ** there is never the intention to emit any actual code from these entities. + ** As a safety measure, such _stricly metaprogramming related_ facilities may be + ** marked to provoke a compilation failure, when the compiler -- accidentally -- + ** attempts to generate code to incorporate such an entity into the runtime world. + ** + ** \par example + ** The classical example is a marker type used to select one of various implementation + ** flavours of a given facility. In fact this helper was created to mark variations + ** based on the time code format in use. + ** @see timecode.hpp */ @@ -37,7 +50,7 @@ namespace meta{ /** * An Entity never to be instantiated. - * Marker baseclass for elements used for metaprogramming only. + * Marker baseclass for elements used in metaprogramming only. * Every attempt to instantiate such an element will cause an * compilation failure */ diff --git a/src/lib/meta/size-trait.hpp b/src/lib/meta/size-trait.hpp index 10cd0b831..6eb7aaced 100644 --- a/src/lib/meta/size-trait.hpp +++ b/src/lib/meta/size-trait.hpp @@ -22,7 +22,26 @@ /** @file size-trait.hpp - ** TODO size-trait.hpp + ** Metaprogramming definitions to deal with dependency on implementation size and layout. + ** Sometimes we need to build our code based on very specific assumptions regarding the + ** implementation data layout of library classes we rely on. Typically such happens when + ** we're forced to work around limitations the library provider never intended to be relevant + ** for any client. Which places us into the very unfortunate situation either to abandon some + ** design concept we prefer to use for some other relevant reason, or to do something very + ** evil and nasty (namely to rely on magic numbers, which may break silently when the + ** library provider changes implementation). + ** + ** While this situation can not be solved in principle, at least we may concentrate all + ** these nasty dependencies in a single location. Moreover, we can deal with this situation + ** by constructing our _magic numbers_ at least in a systematic way, which allows us to + ** intersperse static assertions to trigger an alarm when adjustments need to be made. + ** + ** \par typical example + ** A prominent example is boost::format, which causes a lot of code size bloat when used + ** liberally. For that reason, we built a front-end to encapsulate the boost implementation, + ** so any typed flavour of any call needs to be instantiated only once per application. + ** This allows us to use type safe formatting in error messages, but unfortunately forces + ** us to rely on the precise size of the boost::format implementation. */ diff --git a/src/lib/meta/trait-special.hpp b/src/lib/meta/trait-special.hpp index 4be352e30..f5c0f14be 100644 --- a/src/lib/meta/trait-special.hpp +++ b/src/lib/meta/trait-special.hpp @@ -22,7 +22,15 @@ /** @file trait-special.hpp - ** TODO trait-special.hpp + ** Rarely used specialisations of otherwise heavily used generic code. + ** Over time, we've established a set of tiny (meta)programming helpers, used + ** pervasively all over the code base. Such widely used (header) includes incur + ** the danger to increase compilation time and code size, and thus we spent some + ** effort on optimising the dependencies of these headers. Typically, such + ** analyse reveals some obscure and rare extension, which, while used occasionally, + ** maybe even only once, would cause some increase in the "include size profile". + ** + ** The obvious remedy is to move those into a separate header. */ From 933cd81c18263d5c5daeb1e205154642ca4ca694 Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Mon, 7 Nov 2016 15:51:41 +0100 Subject: [PATCH 10/26] Doxygen: fill in missing file level headlines for the Library (test helpers) --- src/lib/test/depend-4test.hpp | 2 +- src/lib/test/event-log.cpp | 49 ----------------------------------- src/lib/test/suite.cpp | 2 +- src/lib/test/test-coll.hpp | 22 ++-------------- src/lib/test/testdummy.hpp | 5 +++- src/lib/test/testoption.cpp | 2 +- src/lib/test/testoption.hpp | 2 +- 7 files changed, 10 insertions(+), 74 deletions(-) delete mode 100644 src/lib/test/event-log.cpp diff --git a/src/lib/test/depend-4test.hpp b/src/lib/test/depend-4test.hpp index 141ba54a6..6168bed7b 100644 --- a/src/lib/test/depend-4test.hpp +++ b/src/lib/test/depend-4test.hpp @@ -23,7 +23,7 @@ /** @file depend-4test.hpp - ** TODO depend-4test.hpp + ** test support code to inject mock variants of depencencies */ diff --git a/src/lib/test/event-log.cpp b/src/lib/test/event-log.cpp deleted file mode 100644 index 4bf1a3abb..000000000 --- a/src/lib/test/event-log.cpp +++ /dev/null @@ -1,49 +0,0 @@ -/* - EventLog - test facility to verify the occurrence of expected events - - Copyright (C) Lumiera.org - 2015, Hermann Vosseler - - 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 event-log.cpp - ** TODO event-log.cpp - */ - - -#include "lib/test/event-log.hpp" -//#include "lib/format-string.hpp" - -//#include - -//using std::string; - -namespace lib { -namespace test{ - - namespace { // internal details - - } // internal details - - - -//Tangible::~Tangible() { } // Emit VTables here... - - - -}} // namespace lib::test diff --git a/src/lib/test/suite.cpp b/src/lib/test/suite.cpp index a28665831..3b3955e1d 100644 --- a/src/lib/test/suite.cpp +++ b/src/lib/test/suite.cpp @@ -22,7 +22,7 @@ /** @file suite.cpp - ** TODO suite.cpp + ** Implementation of a simple test runner / test suite framework for unit testing. */ diff --git a/src/lib/test/test-coll.hpp b/src/lib/test/test-coll.hpp index e6fe7652c..28360c786 100644 --- a/src/lib/test/test-coll.hpp +++ b/src/lib/test/test-coll.hpp @@ -22,7 +22,7 @@ /** @file test-coll.hpp - ** TODO test-coll.hpp + ** some bits of unit test helper code to fabricate collections with test data */ @@ -30,23 +30,15 @@ #define LIB_TEST_TEST_COLL_H -//#include "lib/symbol.hpp" - -//#include -//#include #include #include #include #include -//#include namespace lib { namespace test{ -// using lib::Literal; -// using std::string; -// using std::rand; typedef std::vector VecI; @@ -105,14 +97,4 @@ namespace test{ }} // namespace lib::test - - - -/* === test helper macros === */ - -/** - * Macro to transmogrify... - */ -//#define MAGIC - -#endif +#endif /*LIB_TEST_TEST_COLL_H*/ diff --git a/src/lib/test/testdummy.hpp b/src/lib/test/testdummy.hpp index 4a9e91b7e..5a6744c25 100644 --- a/src/lib/test/testdummy.hpp +++ b/src/lib/test/testdummy.hpp @@ -22,7 +22,10 @@ /** @file testdummy.hpp - ** TODO testdummy.hpp + ** unittest helper code: test dummy object. + ** This dummy includes some distinct random identity marker + ** plus a checksum facility to verify instance management, i.e. + ** to verify each created instance was properly destroyed after use. */ diff --git a/src/lib/test/testoption.cpp b/src/lib/test/testoption.cpp index c5b492500..9f6f3718f 100644 --- a/src/lib/test/testoption.cpp +++ b/src/lib/test/testoption.cpp @@ -22,7 +22,7 @@ /** @file testoption.cpp - ** TODO testoption.cpp + ** Implementation of commandline parsing for the unittest test-suite. */ diff --git a/src/lib/test/testoption.hpp b/src/lib/test/testoption.hpp index fc99558fc..0963ca6b7 100644 --- a/src/lib/test/testoption.hpp +++ b/src/lib/test/testoption.hpp @@ -22,7 +22,7 @@ /** @file testoption.hpp - ** TODO testoption.hpp + ** Commandline options for our unittest test-suite executable. */ From 545a07db332cd536c58b306d1c93f0959ce05cf1 Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Mon, 7 Nov 2016 16:22:04 +0100 Subject: [PATCH 11/26] Doxygen: fill in missing file level headlines for the Library (timecode handling) --- src/lib/time/formats.hpp | 7 ++++++- src/lib/time/grid.hpp | 4 +++- src/lib/time/quantiser.cpp | 2 +- src/lib/time/quantiser.hpp | 13 +++++++++++-- src/lib/time/timecode.cpp | 4 +++- src/lib/time/timecode.hpp | 14 ++++++++++++-- src/lib/time/timequant.hpp | 11 ++++++++++- 7 files changed, 46 insertions(+), 9 deletions(-) diff --git a/src/lib/time/formats.hpp b/src/lib/time/formats.hpp index a3643963e..f1553af75 100644 --- a/src/lib/time/formats.hpp +++ b/src/lib/time/formats.hpp @@ -22,7 +22,12 @@ /** @file formats.hpp - ** TODO formats.hpp + ** Definition of time code formats + ** This header is part of the Lumiera time and timecode handling library + ** and defines the interfaces and types to deal with the common set of + ** time code formats encountered in video editing. The generic handling + ** of _quantised time_ can be parametrised to support and comply to these + ** specific time code formats. */ diff --git a/src/lib/time/grid.hpp b/src/lib/time/grid.hpp index 70a924669..50854ea30 100644 --- a/src/lib/time/grid.hpp +++ b/src/lib/time/grid.hpp @@ -22,7 +22,9 @@ /** @file grid.hpp - ** TODO grid.hpp + ** definition of a time grid abstraction for time and timecode handling. + ** This interface is the foundation to deal with _quantised_ (grid aligned) + ** time values, as is essential for handling of timecode data. */ diff --git a/src/lib/time/quantiser.cpp b/src/lib/time/quantiser.cpp index 6f242ecb5..a2ed4372e 100644 --- a/src/lib/time/quantiser.cpp +++ b/src/lib/time/quantiser.cpp @@ -22,7 +22,7 @@ /** @file quantiser.cpp - ** TODO quantiser.cpp + ** Implementation of support functions to create grid-aligned time and timecode values */ diff --git a/src/lib/time/quantiser.hpp b/src/lib/time/quantiser.hpp index 24cbaeac3..4ed16703d 100644 --- a/src/lib/time/quantiser.hpp +++ b/src/lib/time/quantiser.hpp @@ -22,7 +22,17 @@ /** @file quantiser.hpp - ** TODO quantiser.hpp + ** Library functions to support the formation of grid-aligned time values. + ** This is a crucial part of Lumiera's time and time handling framework; it + ** serves as link between the precise internal time representation and various + ** grid-aligned external standard time representations. The underlying theme is, + ** by forcing all conversions to go through this central set of library functions, + ** the notorious act of frame-aligning / grid-aligning time values, which can not + ** be avoided, will at least be performed in a reproducible and predictable way. + ** Moreover, the time handling library was built in a way such as to encourage + ** use of the internal, abstracted yet precise time entities, so that the + ** inevitable conversion to the imprecise but well-established external + ** entities (frame numbers, SMPTE, drop frame, HMS) happens as late as possible. */ @@ -35,7 +45,6 @@ #include "lib/time/timevalue.hpp" #include "lib/iter-adapter.hpp" -//#include #include #include #include diff --git a/src/lib/time/timecode.cpp b/src/lib/time/timecode.cpp index 5e5e6b0ec..8460516a5 100644 --- a/src/lib/time/timecode.cpp +++ b/src/lib/time/timecode.cpp @@ -22,7 +22,9 @@ /** @file timecode.cpp - ** TODO timecode.cpp + ** Implementation parts of the timecode handling library. + ** @todo a started implementation exists since 2010, + ** yet crucial parts still need to be filled in as of 2016 */ diff --git a/src/lib/time/timecode.hpp b/src/lib/time/timecode.hpp index 203bacd13..bb3a8c5ea 100644 --- a/src/lib/time/timecode.hpp +++ b/src/lib/time/timecode.hpp @@ -22,7 +22,14 @@ /** @file timecode.hpp - ** TODO timecode.hpp + ** Timecode handling library + ** This header defines the foundation interface TCode to represent a grid aligned + ** time specification, given in some well-established time code format. It is complemented + ** by implementations of the most relevant practical time code formats + ** - frame numbers / frame counting + ** - SMPTE (hours, minutes, seconds and frames) -- including drop-frame + ** - HMS (hours, minutes, seconds and fractional seconds) + ** - fractional seconds as rational number */ @@ -50,7 +57,10 @@ namespace time { /** * Interface: fixed format timecode specification. * @see time::format - * @todo WIP-WIP-WIP + * @todo as of 2016 this is basically finished since years, + * but still not in any widespread practical use (not by bad intention, + * simply by lack of opportunities). So this core interface still needs + * some feedback from practice in order to be finalised. */ class TCode { diff --git a/src/lib/time/timequant.hpp b/src/lib/time/timequant.hpp index b029efd04..68ba6b614 100644 --- a/src/lib/time/timequant.hpp +++ b/src/lib/time/timequant.hpp @@ -22,7 +22,16 @@ /** @file timequant.hpp - ** TODO timequant.hpp + ** Support library to represent grid-aligned time specifications + ** This is part of Lumiera's time and time code handling framework. + ** The QuTime entity represents the link between the internal precise + ** time specifications and external representation formatted according + ** to some well established time code format: QuTime both holds a precise + ** internal time::TimeValue entry, plus a reference to the _time grid_ to + ** be used, when it comes to _quantising_ (grid-aligning) those values. + ** And it offers a dedicated API to "materialise" this (still complete and + ** precise) time value into an external representation. + ** */ From 8e6936d0ad957859eb90529cd6774a50b43430ce Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Tue, 8 Nov 2016 13:18:05 +0100 Subject: [PATCH 12/26] Doxygen: fill in missing file level headlines for the Library --- src/lib/allocation-cluster.cpp | 5 +- src/lib/bool-checkable.hpp | 15 +- src/lib/cmdline.cpp | 2 +- src/lib/cmdline.hpp | 8 +- src/lib/depend.hpp | 24 ++- src/lib/dependency-factory.hpp | 6 +- src/lib/frameid.hpp | 9 +- src/lib/hash-fnv.c | 3 +- src/lib/hash-fnv.h | 7 +- src/lib/lifecycle.cpp | 2 +- src/lib/lockerror.c | 2 +- src/lib/lockerror.h | 2 +- src/lib/luid.c | 2 +- src/lib/mpool.c | 2 +- src/lib/mpool.h | 253 +++++++++-------------------- src/lib/mrucache.c | 2 +- src/lib/mrucache.h | 22 +-- src/lib/nobug-init.cpp | 5 +- src/lib/nocopy.hpp | 5 +- src/lib/optional-ref.hpp | 4 +- src/lib/priqueue.c | 2 +- src/lib/psplay.c | 2 +- src/lib/psplay.h | 37 ++--- src/lib/query-diagnostics.hpp | 2 +- src/lib/query-text.cpp | 14 +- src/lib/query-util.cpp | 2 +- src/lib/query-util.hpp | 2 +- src/lib/ref-array.hpp | 12 +- src/lib/safeclib.c | 7 +- src/lib/safeclib.h | 12 +- src/lib/scoped-holder-transfer.hpp | 4 +- src/lib/searchpath.cpp | 2 +- src/lib/searchpath.hpp | 6 +- src/lib/sectionlock.h | 2 +- src/lib/tmpbuf.c | 17 +- src/lib/tmpbuf.h | 30 ++-- src/lib/util-quant.hpp | 2 +- src/lib/util.cpp | 5 +- src/lib/util.hpp | 10 +- src/lib/visitor-dispatcher.hpp | 3 +- src/lib/visitor.hpp | 41 +++-- src/lib/wrapperptr.hpp | 3 +- src/lumiera/main.cpp | 2 +- 43 files changed, 287 insertions(+), 312 deletions(-) diff --git a/src/lib/allocation-cluster.cpp b/src/lib/allocation-cluster.cpp index c7bfcacb2..2ca5d89f8 100644 --- a/src/lib/allocation-cluster.cpp +++ b/src/lib/allocation-cluster.cpp @@ -22,7 +22,10 @@ /** @file allocation-cluster.cpp - ** TODO allocation-cluster.cpp + ** Implementation of [memory management helper functions](\ref allocation-cluster.hpp) + ** for the render engine model. Here, in the actual translation unit, the generic part + ** of these functions is emitted, while the corresponding header provides a strictly + ** typed front-end, based on templates, which forward to the implementation eventually. */ diff --git a/src/lib/bool-checkable.hpp b/src/lib/bool-checkable.hpp index e0bb770ea..529ee521b 100644 --- a/src/lib/bool-checkable.hpp +++ b/src/lib/bool-checkable.hpp @@ -22,7 +22,20 @@ /** @file bool-checkable.hpp - ** TODO bool-checkable.hpp + ** Mix-in for implicit conversion to bool. + ** When inheriting from BoolCheckable, a class becomes convertible + ** to `bool` -- which is implemented by invoking an operation `isValid()` + ** on this class. + ** + ** @deprecated 2016 it is not clear if we'll retain that feature on the long run. + ** Essentially this was needed to work around the dangers of implicit `bool` + ** conversion in C++98, which is largely obsolete since C++11, because the + ** rectified semantics of implicit conversion now prevent most unexpected + ** usages of this conversion function, like e.g. in comparison operators + ** on a derived class. Moreover, fun fact is, the implementation in this + ** header is not even correct, see Ticket #477 + ** On the other hand, the basic idea of exposing a `isValid()` function + ** does not sound too bad... */ diff --git a/src/lib/cmdline.cpp b/src/lib/cmdline.cpp index 38b08dcf5..1d3015fc7 100644 --- a/src/lib/cmdline.cpp +++ b/src/lib/cmdline.cpp @@ -22,7 +22,7 @@ /** @file cmdline.cpp - ** TODO cmdline.cpp + ** Implementation of a wrapper / marker to handle "commandline arguments". */ diff --git a/src/lib/cmdline.hpp b/src/lib/cmdline.hpp index cbd61a807..ec67eef25 100644 --- a/src/lib/cmdline.hpp +++ b/src/lib/cmdline.hpp @@ -22,7 +22,11 @@ /** @file cmdline.hpp - ** TODO cmdline.hpp + ** Class to encapsulate the typical C-style commandline definition. + ** A Cmdline object takes the typical `int argc, int** argv` and _copies_ + ** the referred data into a vector of strings. Thus `Cmdline` is a way to + ** express explicitly on APIs that we are consuming commandline contents, + ** and, moreover, it offers a way more sane interface to deal with those. */ @@ -44,7 +48,7 @@ namespace lib { /** - * Abstraction of the usual "int argc, int** argv"-Commandline, + * Abstraction of the usual `int argc, int** argv`-Commandline, * to be able to treat it as a vector of strings. Inherits from * vector, but provides convenient conversions to * string (joining delimited by space)... diff --git a/src/lib/depend.hpp b/src/lib/depend.hpp index a12c998e5..973a40687 100644 --- a/src/lib/depend.hpp +++ b/src/lib/depend.hpp @@ -42,7 +42,7 @@ This code is heavily inspired by ** functions allows for subclass creation and various other kinds of service management. ** ** - ** \par Why Singletons? Inversion-of-Control and Dependency Injection + ** # Why Singletons? Inversion-of-Control and Dependency Injection ** ** Singletons are frequently over-used, and often they serve as disguised ** global variables to support a procedural programming style. As a remedy, typically @@ -53,19 +53,19 @@ This code is heavily inspired by ** Thus, for Lumiera, the choice to use Singletons was deliberate: we understand the ** Inversion-of-Control principle, yet we want to stay just below the level of building ** a central application manager core. At the usage site, we access a factory for some - ** service by name, where the »name« is actually the type name of an interface - ** or facade. Singleton is used as an implementation of this factory, when the service + ** service *by name*, where the »name« is actually the type name of an interface or + ** facade. Singleton is used as an _implementation_ of this factory, when the service ** is self-contained and can be brought up lazily. ** - ** \par Conventions, Lifecycle and Unit Testing + ** ## Conventions, Lifecycle and Unit Testing ** ** Usually we place an instance of the singleton factory (or some other kind of factory) ** as a static variable within the interface class describing the service or facade. ** As a rule, everything accessible as Singleton is sufficiently self-contained to come - ** up any time -- even prior to \c main(). But at shutdown, any deregistration must be - ** done explicitly using a lifecycle hook. Destructors aren't allowed to do any significant - ** work besides releasing references, and we acknowledge that singletons can be released - ** in \em arbitrary order. + ** up any time -- even prior to `main()`. But at shutdown, any deregistration must be done + ** explicitly using a lifecycle hook. Destructors aren't allowed to do _any significant work_ + ** beyond releasing references, and we acknowledge that singletons can be released + ** in _arbitrary order_. ** ** @see lib::Depend ** @see lib::DependencyFactory @@ -89,6 +89,7 @@ namespace lib { * Access point to singletons and other kinds of dependencies. * Actually this is a Factory object, which is typically placed into a * static field of the Singleton (target) class or some otherwise suitable interface. + * @param SI the class of the Singleton instance * @note uses static fields internally, so all factory configuration is shared per type * @remark there is an ongoing discussion regarding the viability of the * Double Checked Locking pattern, which requires either the context of a clearly defined @@ -98,7 +99,12 @@ namespace lib { * the singleton ctor to be flushed and visible to other threads when releasing the lock? * To my understanding, the answer is yes. See * [POSIX](http://www.opengroup.org/onlinepubs/000095399/basedefs/xbd_chap04.html#tag_04_10) - * @param SI the class of the Singleton instance + * @remark we could consider to rely on a _Meyers Singleton_, where the compiler automatically + * generates the necessary code and guard variable to ensure single-threaded initialisation + * of the instance variable. But the downside of this approach is that we'd loose access + * to the singleton instance variable, which then resides within the scope of a single + * access function. Such would counterfeit the ability to exchange the instance to + * inject a mock for unit testing. */ template class Depend diff --git a/src/lib/dependency-factory.hpp b/src/lib/dependency-factory.hpp index 18b204775..494b1b45a 100644 --- a/src/lib/dependency-factory.hpp +++ b/src/lib/dependency-factory.hpp @@ -22,7 +22,9 @@ /** @file dependency-factory.hpp - ** TODO dependency-factory.hpp + ** Implementation of a singleton factory used to bring up services as dependency. + ** @internal this implementation header belongs to our framework to deal with + ** [service dependencies](\ref depend.hpp) and should not be used directly. */ @@ -45,7 +47,7 @@ namespace lib { /** * @internal Factory to generate and manage service objects classified by type. * An instance of this factory is placed once for each type for use by - * the \c lib::Depend front-end for dependency management. While the latter + * the lib::Depend front-end for dependency management. While the latter * provides the singleton-style initialisation patter, the DependencyFacotry * maintains a customisable factory function for instance creation. Moreover, * the embedded helper template DependencyFactory::InstanceHolder actually diff --git a/src/lib/frameid.hpp b/src/lib/frameid.hpp index 4f2870d8a..40adadfbc 100644 --- a/src/lib/frameid.hpp +++ b/src/lib/frameid.hpp @@ -22,7 +22,14 @@ /** @file frameid.hpp - ** TODO frameid.hpp + ** Marker tuple to identify a specific frame. + ** @todo 2016 the intention was to use this as cache key, and to include + ** some information regarding the processing chain which led up to + ** the calculation of this frame, to allow for intelligent caching + ** and to avoid throwing away most of the frames on each and every + ** tweak of the edit. This marker was added as a preview in 2010 + ** but we didn't get to the point of actually putting that idea + ** into practical use. Yet the basic idea remains desirable... */ diff --git a/src/lib/hash-fnv.c b/src/lib/hash-fnv.c index 9dae835d9..aad48343b 100644 --- a/src/lib/hash-fnv.c +++ b/src/lib/hash-fnv.c @@ -23,7 +23,8 @@ /** @file hash-fnv.c - ** TODO hash-fnv.c + ** Implementation of FNV ("Fowler-Noll-Vo") hashing functions. + ** @remarks code for this implementation is public domain */ diff --git a/src/lib/hash-fnv.h b/src/lib/hash-fnv.h index d8dc5640c..9d1c7a9bb 100644 --- a/src/lib/hash-fnv.h +++ b/src/lib/hash-fnv.h @@ -22,10 +22,9 @@ */ -/** - * @file hash-fnv.h - * Fowler-Noll-Vo Hashes. - * is a non-cryptographic hash function created by Glenn Fowler, Landon Curt Noll, and Phong Vo. +/** @file hash-fnv.h + ** Fowler-Noll-Vo Hashes. + ** FNV is a non-cryptographic hash function created by Glenn Fowler, Landon Curt Noll, and Phong Vo. */ diff --git a/src/lib/lifecycle.cpp b/src/lib/lifecycle.cpp index de73c02df..6b0f003c4 100644 --- a/src/lib/lifecycle.cpp +++ b/src/lib/lifecycle.cpp @@ -22,7 +22,7 @@ /** @file lifecycle.cpp - ** TODO lifecycle.cpp + ** Implementation of installable callbacks for lifecycle events. */ diff --git a/src/lib/lockerror.c b/src/lib/lockerror.c index f78e6af09..39c7430bf 100644 --- a/src/lib/lockerror.c +++ b/src/lib/lockerror.c @@ -22,7 +22,7 @@ /** @file lockerror.c - ** TODO lockerror.c + ** implementation and definitions for error-handling on low-level locking */ diff --git a/src/lib/lockerror.h b/src/lib/lockerror.h index 295a332e9..ba88a3918 100644 --- a/src/lib/lockerror.h +++ b/src/lib/lockerror.h @@ -21,7 +21,7 @@ /** @file lockerror.h - ** TODO lockerror.h + ** definitions and declarations for error-handling on low-level locking */ #ifndef LUMIERA_LOCKERRORS_H diff --git a/src/lib/luid.c b/src/lib/luid.c index a3cc11014..86b965dcf 100644 --- a/src/lib/luid.c +++ b/src/lib/luid.c @@ -22,7 +22,7 @@ /** @file luid.c - ** TODO luid.c + ** Implementation functions for Lumiera's unique object identifier (LUID). */ diff --git a/src/lib/mpool.c b/src/lib/mpool.c index 469305037..9aaa93a01 100644 --- a/src/lib/mpool.c +++ b/src/lib/mpool.c @@ -21,7 +21,7 @@ /** @file mpool.c - ** TODO mpool.c + ** Implementation of pooling memory allocation functions for constant sized objects. */ #include diff --git a/src/lib/mpool.h b/src/lib/mpool.h index bb7ddf184..f4ab30369 100644 --- a/src/lib/mpool.h +++ b/src/lib/mpool.h @@ -21,7 +21,18 @@ /** @file mpool.h - ** TODO mpool.h + ** Pooled memory allocator for constant sized objects + ** *Memory Pools* are implemented as clusters of fixed sized elements. New clusters + ** are allocated on demand or manually preallocated with a mpool_reserve() operation. + ** Some efforts are taken to ensure (cache) locality of the provided memory. + ** All functions are reentrant but not threadsafe, if this is desired it is advised to + ** care for proper locking elsewhere. + ** @warning as of 2016, this is a stalled development effort towards a pooling allocator. + ** An initial working draft was created in 2009, but never challenged by any + ** widespread use beyond some test code. We acknowledge that there _will be_ + ** some kind of optimised allocator -- yet for the time being we rely on + ** several preliminary front-ends, which _could be attached_ to such an + ** allocator eventually, but use plain flat heap allocations right now. */ #include @@ -29,45 +40,19 @@ #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. -//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 -*/ - - -/* -//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 -*/ +/** + * Function prototype for destroying elements. + * When a memory pool gets destroyed it can call a destructor for any element which is still in the pool. + * Use of such a destructor is optional. + * @param self element to be destroyed + */ 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. -*/ +/** + * memory pool management structure. + * This structure should be considered opaque. + */ typedef struct mpool_struct mpool; typedef mpool* MPool; typedef const mpool* const_MPool; @@ -96,81 +81,46 @@ extern void (*mpool_init_hook) (MPool self); /** called before a mpool gets destroyed */ extern void (*mpool_destroy_hook) (MPool self); -/* -//index.mpool_init xref:mpool_init[mpool_init()]:: Initialise a new memory pool -//mpool [[mpool_init]] -//mpool .mpool_init -//mpool Initialise a memory pool, memory pools must be initialised 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 elements 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 -//mpool `self`:: -//mpool pointer to the memory pool structure to be initialised -//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 -*/ +/** + * Initialise a new memory pool. + * Memory pools must be initialised before being used. One can supply + * an optional destructor function for elements, this will be used to destroy elements which are still + * in the pool when it gets destroyed itself. The destructor is _NOT_ called when elements are freed. + * @param self pointer to the memory pool structure to be initialised + * @param elem_size size for a single element + * @param elements_per_cluster how many elements to put into a cluster + * @param dtor pointer to an optional destructor function, may be `NULL` + * @return `self` pointer to the initialised object + */ 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 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 initialised and can be used again, this is some kindof -//mpool exceptional behaviour. -//mpool -//mpool MPool mpool_destroy (MPool self) -//mpool -//mpool `self`:: -//mpool pointer to an initialised memory pool to be destroyed. -//mpool return:: -//mpool self -//mpool -//mpool -*/ +/** + * destroy a memory pool. + * A memory pool not used anymore should be destroyed. This frees all memory allocated with it. + * When a destructor was provided at construction time, then this destructor is used on all non free elements + * before before the clusters are freed. If no destructor was given then the clusters are just freed. + * The destroyed memory pool behaves as if it was freshly initialised and can be used again, this is + * some kind of exceptional behaviour. + * @param self pointer to an initialised memory pool to be destroyed. + * @return `self` + */ MPool mpool_destroy (MPool self); -/* -//index.mpool_purge xref:mpool_purge[mpool_purge()]:: free unused clusters -//mpool [[mpool_purge]] -//mpool .mpool_purge -//mpool -//mpool TODO -//mpool -//mpool -*/ +/** + * free unused clusters. + */ MPool mpool_purge (MPool self); -/* -//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 -*/ +/** + * query number of free elements. + * @param self pointer to the memory pool to be queried + * @return number of elements available in the pool _without allocating a new cluster_ + */ static inline unsigned mpool_available (MPool self) { @@ -178,98 +128,55 @@ mpool_available (MPool self) } -/* -//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 -*/ +/** + * preallocate elements. + * Resize the pool that at least the given number of elements are available without cluster reallocations. + * @param self pointer to the memory pool + * @param nelements minimum number of elements to preallocate + * @return self on success or `NULL` on error + */ MPool mpool_reserve (MPool self, unsigned nelements); -/* -//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 -*/ +/** + * allocate one element from a MPool. To improve cache locality allocations + * are grouped close together to recent allocations. + * @param self pointer to the memory pool + * @return pointer to the allocated memory on success or `NULL` on error + * @note will never fail when enough space was preallocated + */ void* mpool_alloc (MPool self); -/* -//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 -*/ +/** + * allocate one element close to the given reference element. + * To improve cache locality the allocation tries to get an element close by. + * @param self pointer to the memory pool + * @param near reference to another element which should be close to the returned element _(hint only)_ + * @return pointer to the allocated memory on success or `NULL` on error + * @note will never fail when enough space was preallocated + */ void* mpool_alloc_near (MPool self, void* near); -/* -//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 -*/ +/** + * free one element. + * Frees the given element and puts it back into the pool for further allocations. + * @param self pointer to the memory pool + * @param element element to be freed + */ void mpool_free (MPool self, void* element); +/** diagnostic dump of MPool allocation */ void nobug_mpool_dump (const_MPool self, const int depth, const struct nobug_context dump_context, void* extra); - -/* -// Local Variables: -// mode: C -// c-file-style: "gnu" -// indent-tabs-mode: nil -// End: -*/ diff --git a/src/lib/mrucache.c b/src/lib/mrucache.c index 7eacc8339..cfcc2d25e 100644 --- a/src/lib/mrucache.c +++ b/src/lib/mrucache.c @@ -21,7 +21,7 @@ /** @file mrucache.c - ** TODO mrucache.c + ** Implementation of a caching by most recent use. */ #include "lib/safeclib.h" diff --git a/src/lib/mrucache.h b/src/lib/mrucache.h index eeb871981..e2ae8c03d 100644 --- a/src/lib/mrucache.h +++ b/src/lib/mrucache.h @@ -19,20 +19,22 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ -#ifndef LUMIERA_CACHE_H -#define LUMIERA_CACHE_H + +/** @file mrucache.h + ** Most recent used cache. + ** Elements (addressed by a LList node) are either checked in the cache and thereby subject of aging + ** or checked out under control of the user. Most operations require that the cache is locked. + ** @warning not threadsafe. Locking must be done from usage site. + */ + + +#ifndef LIB_MRUCACHE_H +#define LIB_MRUCACHE_H #include "lib/llist.h" #include -/** - * @file - * Most recent used cache - * Elements (addressed by a LList node) are either checked in the cache and thereby subject of aging - * or checked out under control of the user. Most operations require that the cache is locked. This locking - * must be done from elsewhere. - */ /** * Callback function used to destroy/cleanup aged elements. @@ -176,4 +178,4 @@ int lumiera_mrucache_age (LumieraMruCache self, int nelem); -#endif +#endif /*LIB_MRUCACHE_H*/ diff --git a/src/lib/nobug-init.cpp b/src/lib/nobug-init.cpp index ca13baad0..0c222275b 100644 --- a/src/lib/nobug-init.cpp +++ b/src/lib/nobug-init.cpp @@ -22,11 +22,12 @@ /** @file nobug-init.cpp - ** TODO nobug-init.cpp + ** Implementation function for automatic trigger of NoBug initialisation + ** @note `#include` nobug-init.hpp to use this initialisation automatically */ -#include "lib/nobug-init.hpp" +#include /// magic to generate NoBug logging definitions #define LUMIERA_NOBUG_INIT_CPP diff --git a/src/lib/nocopy.hpp b/src/lib/nocopy.hpp index 6fd3db8a7..e916306a3 100644 --- a/src/lib/nocopy.hpp +++ b/src/lib/nocopy.hpp @@ -22,7 +22,10 @@ /** @file nocopy.hpp - ** TODO nocopy.hpp + ** Mix-Ins to allow or prohibit various degrees of copying and cloning. + ** @todo 2016 this could be organised way better. Also C++11 offers a way more + ** elegant way of expressing the intention. We could get rid of `boost::noncopyable` + ** The basic idea of using a marker mixin seems very reasonable though. ////////////////////////////TICKET #1084 */ diff --git a/src/lib/optional-ref.hpp b/src/lib/optional-ref.hpp index 4baad2112..ee32ea0e2 100644 --- a/src/lib/optional-ref.hpp +++ b/src/lib/optional-ref.hpp @@ -22,7 +22,9 @@ /** @file optional-ref.hpp - ** TODO optional-ref.hpp + ** a checked, switchable reference. + ** Offers semantics similar to a pointer, but throws (not segfaults) + ** on invalid dereferentiation */ diff --git a/src/lib/priqueue.c b/src/lib/priqueue.c index 10b79d6bc..e32da1d84 100644 --- a/src/lib/priqueue.c +++ b/src/lib/priqueue.c @@ -22,7 +22,7 @@ /** @file priqueue.c - ** TODO priqueue.c + ** a simple "text book" implementation of a priority queue, based on a binary heap */ diff --git a/src/lib/psplay.c b/src/lib/psplay.c index ae154a232..478441f60 100644 --- a/src/lib/psplay.c +++ b/src/lib/psplay.c @@ -23,7 +23,7 @@ /** @file psplay.c - ** TODO psplay.c + ** Probabilistic splay tree implementation */ #include "include/logging.h" diff --git a/src/lib/psplay.h b/src/lib/psplay.h index f88ac8cb5..5bad01128 100644 --- a/src/lib/psplay.h +++ b/src/lib/psplay.h @@ -21,23 +21,25 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ -#ifndef PSPLAY_H -#define PSPLAY_H + +/** @file psplay.h + ** Probabilistic splay tree. + ** A splay trees is self-optimising (in contrast to self-balancing) datastructure. + ** We introduce here a probabilistic bottom up approach which reduces the splay costs. + ** Without affecting the performance. The randomisation gives also some insurance that + ** worst case situations are extremely unlikely. + ** + ** Tree nodes are very small (just 2 pointers) and are intrusively placed into the users + ** datastructure. + */ + + +#ifndef LIB_PSPLAY_H +#define LIB_PSPLAY_H #include #include -/** - * @file - * Probabilistic splay trees - * A splay trees is self-optimizing (in contrast to self-balancing) datastructure. - * We introduce here a probabilistic bottom up approach which reduces the splay costs. - * Without affecting the performance. The randomization gives also some insurance that - * worst case situations are extremely unlikely. - * Tree nodes are very small (just 2 pointers) and are intrusively placed into the users - * datastructure. - */ - /** * Type and handle for a psplay tree node @@ -283,11 +285,4 @@ psplay_walk (PSplay self, PSplaynode node, psplay_action_fn action, int level, v void psplay_dump (PSplay self, FILE* dest); -#endif -/* -// Local Variables: -// mode: C -// c-file-style: "gnu" -// indent-tabs-mode: nil -// End: -*/ +#endif /*LIB_PSPLAY_H*/ diff --git a/src/lib/query-diagnostics.hpp b/src/lib/query-diagnostics.hpp index 5bae2f35a..f7283fe37 100644 --- a/src/lib/query-diagnostics.hpp +++ b/src/lib/query-diagnostics.hpp @@ -22,7 +22,7 @@ /** @file query-diagnostics.hpp - ** TODO query-diagnostics.hpp + ** diagnostic helpers to support test related to predicate queries */ diff --git a/src/lib/query-text.cpp b/src/lib/query-text.cpp index d09ba8bb9..6a3f152db 100644 --- a/src/lib/query-text.cpp +++ b/src/lib/query-text.cpp @@ -22,32 +22,20 @@ /** @file query-text.cpp - ** TODO query-text.cpp + ** Implementation bits regarding a syntactical standard representation of predicate queries */ -//#include "lib/util.hpp" -//#include "lib/symbol.hpp" -//#include "include/logging.h" #include "lib/query-text.hpp" -//#include #include #include -//#include -//using std::map; using std::string; -//using util::contains; -//using util::isnil; namespace lib { - namespace { // internal details - - } // internal details - /** Parse, verify and normalise the raw query definition * @warning right now (2012) we don't normalise at all diff --git a/src/lib/query-util.cpp b/src/lib/query-util.cpp index d91c99d89..b370018d9 100644 --- a/src/lib/query-util.cpp +++ b/src/lib/query-util.cpp @@ -22,7 +22,7 @@ /** @file query-util.cpp - ** TODO query-util.cpp + ** Implementation of helpers for working with predicate queries. */ diff --git a/src/lib/query-util.hpp b/src/lib/query-util.hpp index f604d3904..a76f4a6ca 100644 --- a/src/lib/query-util.hpp +++ b/src/lib/query-util.hpp @@ -22,7 +22,7 @@ /** @file query-util.hpp - ** TODO query-util.hpp + ** Utilities to support working with predicate queries */ diff --git a/src/lib/ref-array.hpp b/src/lib/ref-array.hpp index 7f79fb40f..22545c792 100644 --- a/src/lib/ref-array.hpp +++ b/src/lib/ref-array.hpp @@ -22,7 +22,9 @@ /** @file ref-array.hpp - ** TODO ref-array.hpp + ** Abstraction interface: array-like access by subscript + ** @todo as of 2016, this concept seems very questionable: do we _really_ want + ** to abstract over random access, or do we _actually_ want for-iteration?? */ @@ -42,12 +44,14 @@ namespace lib { * holding subclasses. */ template - struct RefArray : boost::noncopyable + class RefArray + : boost::noncopyable { + public: + virtual ~RefArray() {} ///< this is an interface + virtual T const& operator[] (size_t i) const =0; virtual size_t size() const =0; - - virtual ~RefArray() {} }; diff --git a/src/lib/safeclib.c b/src/lib/safeclib.c index 8dc295956..72fb9688a 100644 --- a/src/lib/safeclib.c +++ b/src/lib/safeclib.c @@ -17,12 +17,15 @@ 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 safeclib.c - ** TODO safeclib.c + ** Implementation of error-safe wrappers for some notorious C-Lib functions. */ + + #include "lib/error.h" #include "lib/safeclib.h" diff --git a/src/lib/safeclib.h b/src/lib/safeclib.h index c1fe79554..2a6ab5fb0 100644 --- a/src/lib/safeclib.h +++ b/src/lib/safeclib.h @@ -1,5 +1,5 @@ /* - safe_clib.h - Portable and safe wrappers around some clib functions and some tools + SAFECLIB.h - Portable and safe wrappers around some clib functions and some tools Copyright (C) CinelerraCV 2008, Christian Thaeter @@ -19,14 +19,16 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ + +/** @file safeclib.h + ** Portable and safe wrappers around some C-Lib functions + */ + + #include "error.h" #include -/** - * @file - * Portable and safe wrappers around some clib functions and some tools - */ LUMIERA_ERROR_DECLARE(NO_MEMORY); /** diff --git a/src/lib/scoped-holder-transfer.hpp b/src/lib/scoped-holder-transfer.hpp index a8b36401d..f6f6df242 100644 --- a/src/lib/scoped-holder-transfer.hpp +++ b/src/lib/scoped-holder-transfer.hpp @@ -22,7 +22,9 @@ /** @file scoped-holder-transfer.hpp - ** TODO scoped-holder-transfer.hpp + ** A mechanism to take ownership without allowing copy. + ** @deprecated obsolete concept, superseded by C++11 rvalue references + ** @todo expunge this! */ diff --git a/src/lib/searchpath.cpp b/src/lib/searchpath.cpp index 2f67f6e7e..4ff7be21f 100644 --- a/src/lib/searchpath.cpp +++ b/src/lib/searchpath.cpp @@ -22,7 +22,7 @@ /** @file searchpath.cpp - ** TODO searchpath.cpp + ** Implementation of helpers to handle directory search paths. */ diff --git a/src/lib/searchpath.hpp b/src/lib/searchpath.hpp index 3de3c6c92..88a3f0c5b 100644 --- a/src/lib/searchpath.hpp +++ b/src/lib/searchpath.hpp @@ -22,7 +22,11 @@ /** @file searchpath.hpp - ** TODO searchpath.hpp + ** Helpers to handle directory search paths. + ** The SerachPathSplitter allows to evaluate a "path" like specification + ** with colon separated components. It is complemented by some magic convenience + ** functions to self-discover the currently running executable and to resolve + ** the `$ORIGIN` pattern similar to what is known from linker `rpath` / `runpath` */ diff --git a/src/lib/sectionlock.h b/src/lib/sectionlock.h index 28245029d..1e2f3e056 100644 --- a/src/lib/sectionlock.h +++ b/src/lib/sectionlock.h @@ -21,7 +21,7 @@ /** @file sectionlock.h - ** TODO sectionlock.h + ** Mutex state handle for locked code sections */ #ifndef LUMIERA_SECTIONLOCK_H diff --git a/src/lib/tmpbuf.c b/src/lib/tmpbuf.c index 59bb180f6..f5993b959 100644 --- a/src/lib/tmpbuf.c +++ b/src/lib/tmpbuf.c @@ -1,5 +1,5 @@ /* - tmpbuf.c - Round Robin Temporary buffers + Tmpbuf - Round Robin Temporary buffers Copyright (C) Lumiera.org 2008, 2010 Christian Thaeter @@ -17,12 +17,18 @@ 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 tmpbuf.c - ** TODO tmpbuf.c + ** Implementation of temporary buffers with round-robin usage pattern. + ** + ** @warning this is the restored old version from bc989dab7a97fc69c (July 2010) + ** (the improved version is still buggy as of 5/2011) */ + + #include "lib/safeclib.h" #include "lib/tmpbuf.h" @@ -34,11 +40,6 @@ #include -/*!! WARNING - *!! - *!! this is the restored old version from bc989dab7a97fc69c (July 2010) - *!! (the improved version is still buggy as of 5/2011) - */ struct lumiera_tmpbuf_struct { diff --git a/src/lib/tmpbuf.h b/src/lib/tmpbuf.h index 76b3ceaec..f67c7ef62 100644 --- a/src/lib/tmpbuf.h +++ b/src/lib/tmpbuf.h @@ -1,5 +1,5 @@ /* - tmpbuf.c - Round Robin Temporary buffers + TMPBUF.h - Round Robin Temporary buffers Copyright (C) Lumiera.org 2008, 2010 Christian Thaeter @@ -17,29 +17,37 @@ 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 tmpbuf.h + ** Round robin temporary buffers. + ** This helper provides some buffers per thread which are round-robin recycled with each use. + ** The idea is to have fast buffers for temporal data without need for explicit heap management. + ** There is a fixed number of buffers per thread, which will be re-used with a round-robin pattern, + ** without any safety checks. The caller just needs to ensure not to use too much of these buffers. + ** Typical usage is for "just printing a damn number", hand it over to a library, which will copy + ** the data anyway. + ** + ** @warning this is the restored old version from bc989dab7a97fc69c (July 2010) + ** (the improved version is still buggy as of 5/2011) + */ + + #ifndef LUMIERA_TMPBUF_H #define LUMIERA_TMPBUF_H #include -/** - * @file - * Round robin temporary buffers. - * This provides some buffers per thread which are round-robin recycled with each use. - * The idea is to have fast buffers for temporal data without need for explicit heap management. - * - * @warning this is the restored old version from bc989dab7a97fc69c (July 2010) - * (the improved version is still buggy as of 5/2011) - */ -/* following value must be exponent of 2 */ /** * Number of buffers in the ring * This also defines how many concurent buffers can be in use in one thread (including nested calls) * tmpbufs are only suitable for nested calls where one knows in advance how much tmpbufs might be used + * + * @warning the value defined here must be a power of 2 */ #define LUMIERA_TMPBUF_NUM 16 diff --git a/src/lib/util-quant.hpp b/src/lib/util-quant.hpp index c0d4bd30b..063ee430b 100644 --- a/src/lib/util-quant.hpp +++ b/src/lib/util-quant.hpp @@ -22,7 +22,7 @@ /** @file util-quant.hpp - ** TODO util-quant.hpp + ** Utilities for quantisation (grid alignment) and comparisons. */ diff --git a/src/lib/util.cpp b/src/lib/util.cpp index 0eeb3c174..7ab8dfe67 100644 --- a/src/lib/util.cpp +++ b/src/lib/util.cpp @@ -22,7 +22,10 @@ /** @file util.cpp - ** TODO util.cpp + ** Implementation of widely used helper functions. + ** The helpers implemented here are typically accessed by including util.hpp, + ** so the reason of pushing down the implementation into a separate translation unit + ** (this one here) is to avoid more heavyweight includes (e.g. boost). */ diff --git a/src/lib/util.hpp b/src/lib/util.hpp index 4e00fc7ae..c3a3e6291 100644 --- a/src/lib/util.hpp +++ b/src/lib/util.hpp @@ -22,7 +22,15 @@ /** @file util.hpp - ** TODO util.hpp + ** Tiny helper functions and shortcuts to be used _everywhere_ + ** Consider this header to be effectively included in almost every translation unit. + ** @remark The motivation of using these helpers is conciseness and uniformity of expression. + ** There are several extensions and not-so-frequently used supplements packaged into + ** separate headers. + ** @warning be sure to understand the ramifications of including _anything_ here... + ** @see util-coll.hpp + ** @see uitl-foreach.hpp + ** @see util-quant.hpp */ diff --git a/src/lib/visitor-dispatcher.hpp b/src/lib/visitor-dispatcher.hpp index 60dbc78e5..034d25b9e 100644 --- a/src/lib/visitor-dispatcher.hpp +++ b/src/lib/visitor-dispatcher.hpp @@ -22,7 +22,8 @@ /** @file visitor-dispatcher.hpp - ** TODO visitor-dispatcher.hpp + ** Helper for a trampoline table based implementation of the visitor pattern. + ** @internal implementation part, clients should include visitor.hpp */ diff --git a/src/lib/visitor.hpp b/src/lib/visitor.hpp index 08b3a8abc..f15eae4b0 100644 --- a/src/lib/visitor.hpp +++ b/src/lib/visitor.hpp @@ -36,8 +36,8 @@ Credits for many further implementation ideas go to /** @file visitor.hpp - ** A library implementation of the Visitor Pattern tailored specifically - ** to Lumiera's needs within the Proc Layer. Visitor enables double dispatch + ** A library implementation of the *Visitor Pattern* tailored specifically + ** to Lumiera's needs within the Proc Layer. Visitor enables *double dispatch* ** 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 concrete types and is @@ -47,22 +47,27 @@ Credits for many further implementation ideas go to ** concrete target visitable type. ** ** Implementation notes - **
  • driven by dispatch tables with trampoline functions.
    • - **
  • uses Typelists and Template metaprogramming to generate - ** Dispatcher tables for the concrete types.
    • - **
  • individual Visiting Tool implementation classes need to derive - ** from some Applicable > instantiation - ** and thus define which calls they get dispatched. This is \b crucial. - ** A concrete type not declared in this way will never be dispatched to this - ** concrete visiting tool implementation class. Of course, the latter is free - ** to implement corresponding "treat(ConcreteVisitable&) functions or fall back - ** on some treat(VisitableInterface&) function.
    • - **
  • 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 `apply(TOOLBASE&)` function. Otherwise, it will be treated by the - ** interface of the next base class using this macro.
    • - **
- ** For design questions and more detailed implementation notes, see the Proc Layer Tiddly Wiki. + ** - driven by dispatch tables with trampoline functions. + ** - uses Typelists and Template metaprogramming to generate + ** Dispatcher tables for the concrete types. + ** - individual Visiting Tool implementation classes need to derive + ** from some Applicable > instantiation + ** and thus define which calls they get dispatched. _This is crucial_. + ** A concrete type not declared in this way will never be dispatched to this + ** concrete visiting tool implementation class. Of course, the latter is free + ** to implement corresponding "treat(ConcreteVisitable&) functions or fall back + ** on some treat(VisitableInterface&) function. + ** - 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 `apply(TOOLBASE&)` function. Otherwise, it will be treated by the + ** interface of the next base class using this macro. + ** + ** @remarks as of 2016, it is not clear if we'll really use this facility; it was meant to play a + ** crucial role in the Builder (which is not implemented yet....). The fundamental idea of relying + ** on a visitor seems still adequate though. For design questions and more detailed implementation + ** notes, see the [TiddlyWiki]. + ** + ** [TiddlyWiki]: http://lumiera.org/wiki/renderengine.html#VisitorUse%20VisitingToolImpl%20BuilderStructures%20BuilderMechanics "Lumiera Tiddly Wiki" ** ** @see visitingtooltest.cpp test cases using our lib implementation ** @see BuilderTool one especially important instantiation diff --git a/src/lib/wrapperptr.hpp b/src/lib/wrapperptr.hpp index 5fb91a003..6c3dfb224 100644 --- a/src/lib/wrapperptr.hpp +++ b/src/lib/wrapperptr.hpp @@ -22,7 +22,8 @@ /** @file wrapperptr.hpp - ** TODO wrapperptr.hpp + ** Wrapper to treat several flavours of smart-pointers uniformly + ** @deprecated as of 2016 we should re-think how to organise visitor use in the Builder */ diff --git a/src/lumiera/main.cpp b/src/lumiera/main.cpp index d74359cbd..817f6dfb1 100644 --- a/src/lumiera/main.cpp +++ b/src/lumiera/main.cpp @@ -23,7 +23,7 @@ /** @file main.cpp - ** TODO main.cpp + ** Lumiera application main function */ From faa9cfca1418729b560cdb79da80ba9e9055966e Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Tue, 8 Nov 2016 13:33:17 +0100 Subject: [PATCH 13/26] Doxygen: fill in missing file level headlines for Proc-Layer --- src/proc/asset.cpp | 2 +- src/proc/asset/meta/time-grid.cpp | 4 ++-- src/proc/assetmanager.cpp | 2 +- src/proc/config-resolver.cpp | 6 +++-- src/proc/controllerfacade.cpp | 37 ------------------------------ src/proc/controllerfacade.hpp | 3 ++- src/proc/facade.cpp | 2 +- src/proc/state.cpp | 38 ------------------------------- src/proc/state.hpp | 10 ++++---- src/proc/streamtype.cpp | 2 +- 10 files changed, 17 insertions(+), 89 deletions(-) delete mode 100644 src/proc/controllerfacade.cpp delete mode 100644 src/proc/state.cpp diff --git a/src/proc/asset.cpp b/src/proc/asset.cpp index 6ae12a6b1..e2c75276e 100644 --- a/src/proc/asset.cpp +++ b/src/proc/asset.cpp @@ -22,7 +22,7 @@ /** @file asset.cpp - ** TODO asset.cpp + ** Default implementation of the [Asset abstraction](\ref asset.hpp) */ diff --git a/src/proc/asset/meta/time-grid.cpp b/src/proc/asset/meta/time-grid.cpp index 153020ede..4c374e573 100644 --- a/src/proc/asset/meta/time-grid.cpp +++ b/src/proc/asset/meta/time-grid.cpp @@ -22,7 +22,7 @@ /** @file time-grid.cpp - ** TODO time-grid.cpp + ** Implementation of access to time-quantised reference scales */ @@ -78,7 +78,7 @@ namespace meta { * smart-ptr-to-Quantiser to that, which then can be * published via the \link advice.hpp "advice system"\endlink * @note this allows to use a time grid just "by name", - * without explicit dependance to the Session / Assets + * without explicit dependence to the Session / Assets */ inline PGrid publishWrapped (TimeGrid& newGrid) diff --git a/src/proc/assetmanager.cpp b/src/proc/assetmanager.cpp index eeb6ad96a..9b7c8a2fa 100644 --- a/src/proc/assetmanager.cpp +++ b/src/proc/assetmanager.cpp @@ -22,7 +22,7 @@ /** @file assetmanager.cpp - ** TODO assetmanager.cpp + ** Implementation of Asset lookup and organisation functions */ diff --git a/src/proc/config-resolver.cpp b/src/proc/config-resolver.cpp index 5c12ae966..ffd865fb3 100644 --- a/src/proc/config-resolver.cpp +++ b/src/proc/config-resolver.cpp @@ -1,4 +1,3 @@ - /* ConfigResolver - concrete setup for rule based configuration @@ -23,7 +22,10 @@ /** @file config-resolver.cpp - ** TODO config-resolver.cpp + ** Implementation of bindings between Proc-Layer objects and rules-based configuration. + ** @todo draft from the early design phase of the Lumiera application. As of 2016, nothing + ** was done on behalf of rules-based configuration, other then preparing the whole architecture + ** for this capability. So this remains one of the most relevant goals of the Project. */ diff --git a/src/proc/controllerfacade.cpp b/src/proc/controllerfacade.cpp deleted file mode 100644 index 2cd9d36e8..000000000 --- a/src/proc/controllerfacade.cpp +++ /dev/null @@ -1,37 +0,0 @@ -/* - ControllerFacade - Facade and service access point for the Proc Layer Controller - - Copyright (C) Lumiera.org - 2008, Hermann Vosseler - - 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 controllerfacade.cpp - ** TODO controllerfacade.cpp - */ - - -#include "proc/controllerfacade.hpp" - -namespace proc_interface { - - /** */ - - - -} // namespace proc_interface diff --git a/src/proc/controllerfacade.hpp b/src/proc/controllerfacade.hpp index 19524433d..b4e8babc4 100644 --- a/src/proc/controllerfacade.hpp +++ b/src/proc/controllerfacade.hpp @@ -22,7 +22,8 @@ /** @file controllerfacade.hpp - ** TODO controllerfacade.hpp + ** unfinished draft for a "Proc-Layer Controller" + ** @todo as of 2016 it very much looks like there wont'be any such thing... */ diff --git a/src/proc/facade.cpp b/src/proc/facade.cpp index 61f774fac..14cff986c 100644 --- a/src/proc/facade.cpp +++ b/src/proc/facade.cpp @@ -22,7 +22,7 @@ /** @file facade.cpp - ** TODO facade.cpp + ** merge description from "gui" branch */ diff --git a/src/proc/state.cpp b/src/proc/state.cpp deleted file mode 100644 index 42779d4ab..000000000 --- a/src/proc/state.cpp +++ /dev/null @@ -1,38 +0,0 @@ -/* - State - Key Interface representing a render process and encapsulating state - - Copyright (C) Lumiera.org - 2008, Hermann Vosseler - - 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 state.cpp - ** TODO state.cpp - */ - - -#include "proc/state.hpp" - -namespace proc_interface { - - ////////////////////////////////TODO: State is a high -level interface, so can we get rid of this implementation file? - /** */ - - - -} // namespace proc_interface diff --git a/src/proc/state.hpp b/src/proc/state.hpp index 555ba257f..618b71b7b 100644 --- a/src/proc/state.hpp +++ b/src/proc/state.hpp @@ -22,7 +22,7 @@ /** @file state.hpp - ** TODO state.hpp + ** Access point to an ongoing render's processing state. */ @@ -48,10 +48,10 @@ namespace engine { /** - * 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. + * Abstraction to access 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 diff --git a/src/proc/streamtype.cpp b/src/proc/streamtype.cpp index 057256c93..272390fb9 100644 --- a/src/proc/streamtype.cpp +++ b/src/proc/streamtype.cpp @@ -22,7 +22,7 @@ /** @file streamtype.cpp - ** TODO streamtype.cpp + ** Implementation of a _stream type_ framework */ From 88405c3f2a2f90e754ae7b7c2e8d9c0671a1b7f3 Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Tue, 8 Nov 2016 14:18:28 +0100 Subject: [PATCH 14/26] Doxygen: fill in missing file level headlines for Proc-Layer (Assets) --- src/proc/asset/category.cpp | 2 +- src/proc/asset/category.hpp | 2 +- src/proc/asset/clip.cpp | 2 +- src/proc/asset/clip.hpp | 2 +- src/proc/asset/codec.cpp | 36 ----------------------------- src/proc/asset/codec.hpp | 4 +++- src/proc/asset/compoundmedia.cpp | 39 -------------------------------- src/proc/asset/compoundmedia.hpp | 4 +++- src/proc/asset/dataset.hpp | 4 +++- src/proc/asset/db.hpp | 4 +++- src/proc/asset/effect.cpp | 3 ++- src/proc/asset/effect.hpp | 2 +- src/proc/asset/inventory.hpp | 4 +++- src/proc/asset/media.cpp | 2 +- src/proc/asset/media.hpp | 2 +- src/proc/asset/meta.cpp | 2 +- src/proc/asset/pipe.cpp | 2 +- src/proc/asset/pipe.hpp | 6 ++++- src/proc/asset/preview.cpp | 2 +- src/proc/asset/preview.hpp | 2 +- src/proc/asset/proc.cpp | 2 +- src/proc/asset/procpatt.cpp | 2 +- src/proc/asset/procpatt.hpp | 5 +++- src/proc/asset/sequence.cpp | 2 +- src/proc/asset/sequence.hpp | 4 ++++ src/proc/asset/struct.cpp | 13 ++++++++++- src/proc/asset/struct.hpp | 6 +++-- src/proc/asset/timeline.cpp | 5 +--- src/proc/asset/typed-id.hpp | 2 ++ src/proc/asset/typed-lookup.cpp | 5 +++- src/proc/asset/unknown.cpp | 2 +- src/proc/asset/unknown.hpp | 5 +++- src/proc/asset/viewer.cpp | 3 ++- 33 files changed, 74 insertions(+), 108 deletions(-) delete mode 100644 src/proc/asset/codec.cpp delete mode 100644 src/proc/asset/compoundmedia.cpp diff --git a/src/proc/asset/category.cpp b/src/proc/asset/category.cpp index b1404387f..99c2e5d86 100644 --- a/src/proc/asset/category.cpp +++ b/src/proc/asset/category.cpp @@ -22,7 +22,7 @@ /** @file category.cpp - ** TODO category.cpp + ** Implementation parts regarding Asset categorisation */ diff --git a/src/proc/asset/category.hpp b/src/proc/asset/category.hpp index 51d96f8f1..ce6028921 100644 --- a/src/proc/asset/category.hpp +++ b/src/proc/asset/category.hpp @@ -22,7 +22,7 @@ /** @file category.hpp - ** TODO category.hpp + ** Definition of Asset categorisation */ diff --git a/src/proc/asset/clip.cpp b/src/proc/asset/clip.cpp index fbf634364..405653185 100644 --- a/src/proc/asset/clip.cpp +++ b/src/proc/asset/clip.cpp @@ -22,7 +22,7 @@ /** @file clip.cpp - ** TODO clip.cpp + ** Clip Asset implementation */ diff --git a/src/proc/asset/clip.hpp b/src/proc/asset/clip.hpp index cb3f4a766..6aed11ccc 100644 --- a/src/proc/asset/clip.hpp +++ b/src/proc/asset/clip.hpp @@ -22,7 +22,7 @@ /** @file clip.hpp - ** TODO clip.hpp + ** Definition of Asset representation for a media clip */ diff --git a/src/proc/asset/codec.cpp b/src/proc/asset/codec.cpp deleted file mode 100644 index 3c4571c2e..000000000 --- a/src/proc/asset/codec.cpp +++ /dev/null @@ -1,36 +0,0 @@ -/* - Codec(Asset) - description of some media data decoder or encoder facility - - Copyright (C) Lumiera.org - 2008, Hermann Vosseler - - 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 codec.cpp - ** TODO codec.cpp - */ - - -#include "proc/asset/codec.hpp" - -namespace proc { -namespace asset { - - - -}} // namespace proc::asset diff --git a/src/proc/asset/codec.hpp b/src/proc/asset/codec.hpp index c72e72063..eac62f1e4 100644 --- a/src/proc/asset/codec.hpp +++ b/src/proc/asset/codec.hpp @@ -22,7 +22,9 @@ /** @file codec.hpp - ** TODO codec.hpp + ** Definition of a Codec Asset + ** @deprecated as of 2016 it seems questionable we'll have to deal with such assets, + ** since coding/decoding will always be delegated to widely available libraries. */ diff --git a/src/proc/asset/compoundmedia.cpp b/src/proc/asset/compoundmedia.cpp deleted file mode 100644 index 402758f41..000000000 --- a/src/proc/asset/compoundmedia.cpp +++ /dev/null @@ -1,39 +0,0 @@ -/* - CompoundMedia - multichannel media - - Copyright (C) Lumiera.org - 2008, Hermann Vosseler - - 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 compoundmedia.cpp - ** TODO compoundmedia.cpp - */ - - -#include "proc/asset/compoundmedia.hpp" - -namespace proc { -namespace asset - { - - /** */ - - - - }} // namespace proc::asset diff --git a/src/proc/asset/compoundmedia.hpp b/src/proc/asset/compoundmedia.hpp index 5c5a3e069..2533bc5fa 100644 --- a/src/proc/asset/compoundmedia.hpp +++ b/src/proc/asset/compoundmedia.hpp @@ -22,7 +22,9 @@ /** @file compoundmedia.hpp - ** TODO compoundmedia.hpp + ** Definition of an Asset to represent a clustering or compound of several media + ** @warning early draft, never put into use as of 2016 (but there wasn't a reason to + ** do so either, since we didn't get up to dealing with this topic) */ diff --git a/src/proc/asset/dataset.hpp b/src/proc/asset/dataset.hpp index 3b414dd6e..0188ef778 100644 --- a/src/proc/asset/dataset.hpp +++ b/src/proc/asset/dataset.hpp @@ -22,7 +22,9 @@ /** @file dataset.hpp - ** TODO dataset.hpp + ** Definition of an Asset to represent a set of control data + ** An example would be captured animation data from some kind of external controller. + ** @warning as of 2016, this is a design placeholder. The concept seems reasonable though. */ diff --git a/src/proc/asset/db.hpp b/src/proc/asset/db.hpp index 562a42cb8..b0f097605 100644 --- a/src/proc/asset/db.hpp +++ b/src/proc/asset/db.hpp @@ -22,7 +22,9 @@ /** @file db.hpp - ** TODO db.hpp + ** Implementation of the _Asset database_. + ** Simplistic hash based lookup-table. + ** @internal implementation details of the AssetManager */ diff --git a/src/proc/asset/effect.cpp b/src/proc/asset/effect.cpp index de3a16b62..295837047 100644 --- a/src/proc/asset/effect.cpp +++ b/src/proc/asset/effect.cpp @@ -22,7 +22,8 @@ /** @file effect.cpp - ** TODO effect.cpp + ** Implementation level functionality regarding the Asset representation of effects + ** @todo still unimplemented and stalled work as of 2016 */ diff --git a/src/proc/asset/effect.hpp b/src/proc/asset/effect.hpp index 2a4658f79..78ac74826 100644 --- a/src/proc/asset/effect.hpp +++ b/src/proc/asset/effect.hpp @@ -22,7 +22,7 @@ /** @file effect.hpp - ** TODO effect.hpp + ** Definition of an Asset representation for any kind of _effect_ or media processor. */ diff --git a/src/proc/asset/inventory.hpp b/src/proc/asset/inventory.hpp index 1b70cd032..a0e34c119 100644 --- a/src/proc/asset/inventory.hpp +++ b/src/proc/asset/inventory.hpp @@ -22,7 +22,9 @@ /** @file inventory.hpp - ** TODO inventory.hpp + ** Exposing an ID registration cluster as a Meta Asset + ** @todo implementation draft from 2010, stalled as of 2016, + ** but likely to be of relevance eventually... */ diff --git a/src/proc/asset/media.cpp b/src/proc/asset/media.cpp index 13fb4bf6d..f1d236bcf 100644 --- a/src/proc/asset/media.cpp +++ b/src/proc/asset/media.cpp @@ -22,7 +22,7 @@ /** @file media.cpp - ** TODO media.cpp + ** Implementation regarding the Media Asset abstraction */ diff --git a/src/proc/asset/media.hpp b/src/proc/asset/media.hpp index 9f3e61729..a39b8647e 100644 --- a/src/proc/asset/media.hpp +++ b/src/proc/asset/media.hpp @@ -22,7 +22,7 @@ /** @file media.hpp - ** Media data is a specific kind of Asset. + ** Media data represented a specific kind of Asset. ** For the different kinds of Assets, we use sub-interfaces inheriting ** from the general Asset interface. To be able to get asset::Media instances ** directly from the AssetManager, we define a specialisation of the Asset ID. diff --git a/src/proc/asset/meta.cpp b/src/proc/asset/meta.cpp index 9f7ade718..e2dfe40f5 100644 --- a/src/proc/asset/meta.cpp +++ b/src/proc/asset/meta.cpp @@ -22,7 +22,7 @@ /** @file meta.cpp - ** TODO meta.cpp + ** Implementation details regarding the Meta Asset category */ diff --git a/src/proc/asset/pipe.cpp b/src/proc/asset/pipe.cpp index 92efc3163..5380a7ec5 100644 --- a/src/proc/asset/pipe.cpp +++ b/src/proc/asset/pipe.cpp @@ -22,7 +22,7 @@ /** @file pipe.cpp - ** TODO pipe.cpp + ** Implementation details regarding the Asset representation of a processing Pipe */ diff --git a/src/proc/asset/pipe.hpp b/src/proc/asset/pipe.hpp index dd473b21d..eb89ea964 100644 --- a/src/proc/asset/pipe.hpp +++ b/src/proc/asset/pipe.hpp @@ -22,7 +22,11 @@ /** @file pipe.hpp - ** TODO pipe.hpp + ** A "processing pipe" represented as Asset. + ** The Pipe Asset, especially the ID plays a crucial role within the + ** Session model to represent both attachment points for further media processors + ** and connection designations, which will be resolved to some input/output port + ** during the Builder run. */ diff --git a/src/proc/asset/preview.cpp b/src/proc/asset/preview.cpp index 9f8c42e11..bce74421c 100644 --- a/src/proc/asset/preview.cpp +++ b/src/proc/asset/preview.cpp @@ -22,7 +22,7 @@ /** @file preview.cpp - ** TODO preview.cpp + ** Implementation details regarding a placeholder / "Proxy" / preview media asset */ diff --git a/src/proc/asset/preview.hpp b/src/proc/asset/preview.hpp index 5abf53f3b..a09562b83 100644 --- a/src/proc/asset/preview.hpp +++ b/src/proc/asset/preview.hpp @@ -22,7 +22,7 @@ /** @file preview.hpp - ** TODO preview.hpp + ** Placeholder "proxy" Asset */ diff --git a/src/proc/asset/proc.cpp b/src/proc/asset/proc.cpp index 125ac7023..84242787c 100644 --- a/src/proc/asset/proc.cpp +++ b/src/proc/asset/proc.cpp @@ -22,7 +22,7 @@ /** @file proc.cpp - ** TODO proc.cpp + ** Implementation details regarding the Asset representation of a media processing facility */ diff --git a/src/proc/asset/procpatt.cpp b/src/proc/asset/procpatt.cpp index a53a32335..3de87b1fe 100644 --- a/src/proc/asset/procpatt.cpp +++ b/src/proc/asset/procpatt.cpp @@ -22,7 +22,7 @@ /** @file procpatt.cpp - ** TODO procpatt.cpp + ** Implementation details related to "processing pattern" assets. */ diff --git a/src/proc/asset/procpatt.hpp b/src/proc/asset/procpatt.hpp index 1528222d6..c692d6fb8 100644 --- a/src/proc/asset/procpatt.hpp +++ b/src/proc/asset/procpatt.hpp @@ -22,7 +22,10 @@ /** @file procpatt.hpp - ** TODO procpatt.hpp + ** Definition of a [structural asset](\ref struct.hpp) to express patterns of wiring or processing + ** Processing patterns can be seen as some kind of "micro code" (or macro code, if you prefer this + ** view angle), which will be executed within the machinery to wire and configure the render nodes + ** network, based on the objects in the Session model. */ diff --git a/src/proc/asset/sequence.cpp b/src/proc/asset/sequence.cpp index 928535af2..a5662e419 100644 --- a/src/proc/asset/sequence.cpp +++ b/src/proc/asset/sequence.cpp @@ -22,7 +22,7 @@ /** @file sequence.cpp - ** TODO sequence.cpp + ** Implementation parts of the Sequence entity within the Session model */ diff --git a/src/proc/asset/sequence.hpp b/src/proc/asset/sequence.hpp index 803995819..6e9ba7298 100644 --- a/src/proc/asset/sequence.hpp +++ b/src/proc/asset/sequence.hpp @@ -42,6 +42,10 @@ ** on the name-ID of the sequence: \c Struct::retrieve(Query ("id(theName).")) ** Additionally, a specific fork root may be requested: \c "id(theName),rootFork(trackID)." ** + ** @todo this is a very crucial part of the emerging design of the session model. Unfortunately, + ** development on that frontier has stalled since 2010, since we focused efforts towards + ** the player, the engine and the GUI lately (as of 2016) + ** ** @see Session ** @see StructFactory ** diff --git a/src/proc/asset/struct.cpp b/src/proc/asset/struct.cpp index 15d9388fb..d0aa7836d 100644 --- a/src/proc/asset/struct.cpp +++ b/src/proc/asset/struct.cpp @@ -22,7 +22,18 @@ /** @file struct.cpp - ** TODO struct.cpp + ** Implementation functions to support the "structural asset" abstraction. + ** This translation unit defines some functions of high importance for querying + ** and self-discovery of model parts. Moreover, it drives explicit template specialisations + ** for the core functions of the StructFacotry. + ** + ** # Vision + ** The vision is to express knowledge, configuration and some flexible parts of the model construction + ** through predicate rules. To support this vision, at various places within the translation from + ** Session model to render node network, a _query_ is used instead of hard wired functionality. + ** @todo while most code here is a very preliminary draft (let's call it a hack), as of 2016 + ** we acknowledge that this design is here to stay and represents one of the most + ** distinctive features of Lumiera */ diff --git a/src/proc/asset/struct.hpp b/src/proc/asset/struct.hpp index 02bf26129..ed6a74d75 100644 --- a/src/proc/asset/struct.hpp +++ b/src/proc/asset/struct.hpp @@ -22,9 +22,10 @@ /** @file struct.hpp + ** Asset representation of structural elements within the model. ** Structural parts of the Session (e.g. "tracks", i.e. Fork objects) can be ** reflected into the "bookkeeping view" as a specific Kind of Asset. - ** For the different \em kinds of Assets, we use sub-interfaces inheriting + ** For the different _kinds of Assets_, we use sub-interfaces inheriting ** from the general Asset interface, each of which expose a distinguishing feature. ** In the case of structural assets, the key point is the ability to retrieve an ** instance based on a capabilities query; structural assets are typically created @@ -36,7 +37,8 @@ ** - "tracks" are implemented as Fork represented as \c entryID within the asset view. ** - ProcPatt is used as a blueprint in the build process, a standard connection pattern ** - ** \par access and creation + ** ## access and creation + ** ** asset::Struct instances are created on demand; the interface is to invoke the ** StructFactory with a (typed) Query describing properties or capabilities. ** In case this query succeeds, an existing asset will be returned, otherwise diff --git a/src/proc/asset/timeline.cpp b/src/proc/asset/timeline.cpp index 5eb464633..49c9ae395 100644 --- a/src/proc/asset/timeline.cpp +++ b/src/proc/asset/timeline.cpp @@ -22,14 +22,11 @@ /** @file timeline.cpp - ** TODO timeline.cpp + ** Implementation functions of the Timeline entity within the Session model */ #include "proc/asset/timeline.hpp" -//#include "proc/mobject/session/fork.hpp" -//#include "proc/mobject/placement.hpp" -//#include "proc/mobject/session/mobjectfactory.hpp" #include "proc/mobject/session/binding.hpp" #include "proc/assetmanager.hpp" diff --git a/src/proc/asset/typed-id.hpp b/src/proc/asset/typed-id.hpp index f3bd31763..56c83f902 100644 --- a/src/proc/asset/typed-id.hpp +++ b/src/proc/asset/typed-id.hpp @@ -33,6 +33,8 @@ ** the interfaces. Ichthyo expects this registration service to play a crucial role ** when it comes to integrating a real resolution engine (prolog). For now, the ** only interesting point is how to handle the automatic registration. + ** @todo and as of 2016, we acknowledge the importance of this approach, + ** just the topic is deferred for now and will be picked up later... ** ** @see configrules.hpp ** @see typed-lookup.cpp corresponding implementation diff --git a/src/proc/asset/typed-lookup.cpp b/src/proc/asset/typed-lookup.cpp index 722fe6bf3..3754756bc 100644 --- a/src/proc/asset/typed-lookup.cpp +++ b/src/proc/asset/typed-lookup.cpp @@ -22,7 +22,10 @@ /** @file typed-lookup.cpp - ** TODO typed-lookup.cpp + ** Implementation backend for a registration service to associate IDs, types and object instances + ** @todo this is placeholder code for an important facility, required once we engage into + ** predicate rules based configuration. For now (as of 2016), efforts towards this important + ** goal have been postponed, because we have to focus on a working engine first */ diff --git a/src/proc/asset/unknown.cpp b/src/proc/asset/unknown.cpp index 750ae0845..7f6af5083 100644 --- a/src/proc/asset/unknown.cpp +++ b/src/proc/asset/unknown.cpp @@ -22,7 +22,7 @@ /** @file unknown.cpp - ** TODO unknown.cpp + ** Implementation functions regarding a marker asset for unknown media. */ diff --git a/src/proc/asset/unknown.hpp b/src/proc/asset/unknown.hpp index fc89a5582..9f588030d 100644 --- a/src/proc/asset/unknown.hpp +++ b/src/proc/asset/unknown.hpp @@ -22,7 +22,10 @@ /** @file unknown.hpp - ** TODO unknown.hpp + ** Marker Asset to indicate an unknown media source. + ** Elements marked as Unknown are retained in disabled state within the model. + ** This allows to open and work on a session file, without having all of the + ** data, setup or environment available */ diff --git a/src/proc/asset/viewer.cpp b/src/proc/asset/viewer.cpp index d99fe1386..f111cdab7 100644 --- a/src/proc/asset/viewer.cpp +++ b/src/proc/asset/viewer.cpp @@ -22,7 +22,8 @@ /** @file viewer.cpp - ** TODO viewer.cpp + ** Implementation functions to represent a viewer or viewer attachment point. + ** @todo half finished draft, topic was postponed as of 2014, but will become relevant again */ From a5c99510120ac1f89e0eae2b7d98ad8151597863 Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Tue, 8 Nov 2016 14:34:39 +0100 Subject: [PATCH 15/26] Doxygen: fill in missing file level headlines for Proc-Layer (Controller) --- src/proc/control/argument-erasure.hpp | 3 ++- src/proc/control/handling-pattern.cpp | 3 ++- src/proc/control/mediaimpllib.hpp | 9 ++++++++- src/proc/control/pathmanager.cpp | 4 +++- src/proc/control/pathmanager.hpp | 6 +++++- src/proc/control/proc-dispatcher.cpp | 2 +- src/proc/control/stypemanager.cpp | 2 +- src/proc/control/stypemanager.hpp | 4 +++- 8 files changed, 25 insertions(+), 8 deletions(-) diff --git a/src/proc/control/argument-erasure.hpp b/src/proc/control/argument-erasure.hpp index 69928a0dc..6345849d1 100644 --- a/src/proc/control/argument-erasure.hpp +++ b/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). */ diff --git a/src/proc/control/handling-pattern.cpp b/src/proc/control/handling-pattern.cpp index 6d61c0cb0..da1188175 100644 --- a/src/proc/control/handling-pattern.cpp +++ b/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. */ diff --git a/src/proc/control/mediaimpllib.hpp b/src/proc/control/mediaimpllib.hpp index ed4fb7dc2..cf60e101d 100644 --- a/src/proc/control/mediaimpllib.hpp +++ b/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. */ diff --git a/src/proc/control/pathmanager.cpp b/src/proc/control/pathmanager.cpp index 5043a6428..46d97ff64 100644 --- a/src/proc/control/pathmanager.cpp +++ b/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 */ diff --git a/src/proc/control/pathmanager.hpp b/src/proc/control/pathmanager.hpp index b2a612dea..f925bc7e6 100644 --- a/src/proc/control/pathmanager.hpp +++ b/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. */ diff --git a/src/proc/control/proc-dispatcher.cpp b/src/proc/control/proc-dispatcher.cpp index 9e7acd9a1..b0d8a62f2 100644 --- a/src/proc/control/proc-dispatcher.cpp +++ b/src/proc/control/proc-dispatcher.cpp @@ -22,7 +22,7 @@ /** @file proc-dispatcher.cpp - ** TODO proc-dispatcher.cpp + ** @todo merge from gui branch */ diff --git a/src/proc/control/stypemanager.cpp b/src/proc/control/stypemanager.cpp index cfb5740bc..a0e6b9569 100644 --- a/src/proc/control/stypemanager.cpp +++ b/src/proc/control/stypemanager.cpp @@ -22,7 +22,7 @@ /** @file stypemanager.cpp - ** TODO stypemanager.cpp + ** Implementation functions of the stream type system */ diff --git a/src/proc/control/stypemanager.hpp b/src/proc/control/stypemanager.hpp index 70261638f..f7fb27874 100644 --- a/src/proc/control/stypemanager.hpp +++ b/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 */ From 9676d1736624fbd79536d531f9e134bb1267af56 Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Wed, 9 Nov 2016 19:13:52 +0100 Subject: [PATCH 16/26] Doxygen: fill in missing file level headlines for Proc-Layer (Engine I) --- src/backend/engine/job.h | 4 +- src/proc/engine/buffer-local-key.hpp | 2 +- src/proc/engine/buffer-provider.cpp | 2 +- src/proc/engine/bufftable-obsolete.hpp | 3 +- src/proc/engine/bufftable.hpp | 6 +- src/proc/engine/calc-plan-continuation.cpp | 3 +- src/proc/engine/calc-plan-continuation.hpp | 9 ++- src/proc/engine/calc-stream.hpp | 21 +++++-- .../engine/diagnostic-buffer-provider.cpp | 5 +- .../engine/diagnostic-buffer-provider.hpp | 2 +- src/proc/engine/dispatch-table.cpp | 3 +- src/proc/engine/dispatch-table.hpp | 3 +- src/proc/engine/dispatcher.cpp | 7 ++- src/proc/engine/dispatcher.hpp | 10 +++- src/proc/engine/engine-service-mock.cpp | 3 +- src/proc/engine/engine-service.cpp | 2 +- src/proc/engine/engine-service.hpp | 8 +-- src/proc/engine/frame-coord.hpp | 6 +- src/proc/engine/job-ticket.hpp | 11 ++-- src/proc/engine/link.cpp | 40 ------------- src/proc/engine/link.hpp | 59 ------------------- src/proc/engine/mask.cpp | 22 ++++--- src/proc/engine/mask.hpp | 34 ++++++----- src/proc/engine/nodeinvocation.hpp | 6 +- src/proc/engine/source.cpp | 18 +++--- src/proc/engine/source.hpp | 9 ++- .../engine/worker/dummy-image-generator.cpp | 3 +- .../engine/worker/dummy-image-generator.hpp | 1 + 28 files changed, 136 insertions(+), 166 deletions(-) delete mode 100644 src/proc/engine/link.cpp delete mode 100644 src/proc/engine/link.hpp diff --git a/src/backend/engine/job.h b/src/backend/engine/job.h index 43b6d57d2..cd77fcb7f 100644 --- a/src/backend/engine/job.h +++ b/src/backend/engine/job.h @@ -27,12 +27,12 @@ ** for time bound invocation. This header defines the data structures used to describe ** a job, and the basic data structures used by the scheduler to keep track of individual ** jobs. Moreover, within the C++ part of this header, some classes are layered on top - ** of these data structures; especially the JobClosure ABC describes the \em generic part + ** of these data structures; especially the JobClosure ABC describes the _generic part_ ** of each job, while the "moving parts" are embedded within the lumiera_jobParameter. ** ** A render job is a parameterless function, ready to be invoked by the scheduler.. ** Since every non trivial job actually needs some parameters (at least a frame number) - ** and relies on additional definitions and data structures, a \em closure is created + ** and relies on additional definitions and data structures, a _closure_ is created ** to make these dependencies explicit and opaque for the scheduler. The actual ** job invocation is forwarded to a virtual function JobClosure#invokeJobOperation(JobParameter), ** which is defined "somewhere" in a subclass and remains opaque for the scheduler; diff --git a/src/proc/engine/buffer-local-key.hpp b/src/proc/engine/buffer-local-key.hpp index 525ef85ab..ac2b266d2 100644 --- a/src/proc/engine/buffer-local-key.hpp +++ b/src/proc/engine/buffer-local-key.hpp @@ -22,7 +22,7 @@ /** @file buffer-local-key.hpp - ** TODO buffer-local-key.hpp + ** A marker data type used in metadata / buffer management of the render engine. */ diff --git a/src/proc/engine/buffer-provider.cpp b/src/proc/engine/buffer-provider.cpp index 5d5ed11ed..9a25711a8 100644 --- a/src/proc/engine/buffer-provider.cpp +++ b/src/proc/engine/buffer-provider.cpp @@ -22,7 +22,7 @@ /** @file buffer-provider.cpp - ** TODO buffer-provider.cpp + ** Implementation details related to buffer lifecycle management in the render engine. */ diff --git a/src/proc/engine/bufftable-obsolete.hpp b/src/proc/engine/bufftable-obsolete.hpp index 55bcf125c..7cb1b17ba 100644 --- a/src/proc/engine/bufftable-obsolete.hpp +++ b/src/proc/engine/bufftable-obsolete.hpp @@ -22,7 +22,8 @@ /** @file bufftable-obsolete.hpp - ** TODO bufftable-obsolete.hpp + ** @deprecated obsolete since 2009, left in tree to keep some likewise unfinished code alive. + ** @see nodeinvocation.hpp */ diff --git a/src/proc/engine/bufftable.hpp b/src/proc/engine/bufftable.hpp index 7942f7ea6..a0f1289f8 100644 --- a/src/proc/engine/bufftable.hpp +++ b/src/proc/engine/bufftable.hpp @@ -22,7 +22,11 @@ /** @file bufftable.hpp - ** TODO bufftable.hpp + ** helper for organisation of render data buffers + ** Used during the process of _"pulling"_ a render node, which recursively might + ** pull further nodes. Any node has a _render calculation function,_ which in turn + ** needs input and output buffers + ** @see buffer-provider.hpp */ diff --git a/src/proc/engine/calc-plan-continuation.cpp b/src/proc/engine/calc-plan-continuation.cpp index 1ad885f0e..84aaaa463 100644 --- a/src/proc/engine/calc-plan-continuation.cpp +++ b/src/proc/engine/calc-plan-continuation.cpp @@ -22,7 +22,8 @@ /** @file calc-plan-continuation.cpp - ** TODO calc-plan-continuation.cpp + ** Implementation elements of render process planning. + ** @todo a draft created in 2013 and then stalled. This is not obsolete. */ diff --git a/src/proc/engine/calc-plan-continuation.hpp b/src/proc/engine/calc-plan-continuation.hpp index 772227e81..ba45ca6c1 100644 --- a/src/proc/engine/calc-plan-continuation.hpp +++ b/src/proc/engine/calc-plan-continuation.hpp @@ -22,7 +22,14 @@ /** @file calc-plan-continuation.hpp - ** TODO calc-plan-continuation.hpp + ** A specialised render job to care for the planning of the calculation process itself. + ** Rendering is seen as an open-ended, ongoing process, and thus the management and planning + ** of the render process itself is performed chunk wise and embedded into the other rendering + ** calculations. The _"rendering-as-it-is-planned-right-now"_ can be represented as a closure + ** to the jobs, which perform and update this plan on the go. And in fact, the head of the + ** calculation process, the CalcStream, holds onto such a closure to access current planning. + ** + ** @todo a draft created in 2013 and then stalled. This is not obsolete. */ diff --git a/src/proc/engine/calc-stream.hpp b/src/proc/engine/calc-stream.hpp index f4ab86958..add298ffa 100644 --- a/src/proc/engine/calc-stream.hpp +++ b/src/proc/engine/calc-stream.hpp @@ -22,7 +22,21 @@ /** @file calc-stream.hpp - ** TODO calc-stream.hpp + ** A core abstraction within the render engine to represent an ongoing calculation. + ** Within the Lumiera render engine, the rendering process is modelled in a functional way, + ** as a _stream of calculations_ -- which eventually result in a stream of data frames. + ** Typically, streams in this context are conceived as unlimited and open-ended, and + ** can be represented by a generator or continuation function. Moreover, the invocation + ** of this "continue-the-stream"-function is embedded into the other rendering calculations + ** as a series of planning jobs. Whose purpose is, to create further future calculation jobs, + ** including future planning jobs. + ** + ** All of this structure thus exists only dynamically, always in ongoing evaluation. + ** For the interface level we thus create a symbolic placeholder, the CalcStream object + ** + ** @see engine-service.hpp + ** @todo this draft was created in 2013 just to the point of defining the skeleton of the engine. + ** @todo as of 2016, this is considered the way to go and will be completed _eventually_ */ @@ -144,6 +158,5 @@ namespace engine{ -} // namespace engine -} // namespace proc -#endif +}}// namespace proc::engine +#endif /*PROC_ENGINE_CALC_STREAM_H*/ diff --git a/src/proc/engine/diagnostic-buffer-provider.cpp b/src/proc/engine/diagnostic-buffer-provider.cpp index 10206930d..53123b640 100644 --- a/src/proc/engine/diagnostic-buffer-provider.cpp +++ b/src/proc/engine/diagnostic-buffer-provider.cpp @@ -22,7 +22,10 @@ /** @file diagnostic-buffer-provider.cpp - ** TODO diagnostic-buffer-provider.cpp + ** Implementation details of unit test support regarding internals of the render engine. + ** + ** @todo WIP from 2013, half finished, stalled + ** @see buffer-provider-protocol-test.cpp */ diff --git a/src/proc/engine/diagnostic-buffer-provider.hpp b/src/proc/engine/diagnostic-buffer-provider.hpp index 18636d7dc..5024924ee 100644 --- a/src/proc/engine/diagnostic-buffer-provider.hpp +++ b/src/proc/engine/diagnostic-buffer-provider.hpp @@ -22,7 +22,7 @@ /** @file diagnostic-buffer-provider.hpp ** A facility for writing unit-tests targeting the BufferProvider interface. - ** + ** ** @see buffer-provider-protocol-test.cpp */ diff --git a/src/proc/engine/dispatch-table.cpp b/src/proc/engine/dispatch-table.cpp index 45e285e86..e7b603df0 100644 --- a/src/proc/engine/dispatch-table.cpp +++ b/src/proc/engine/dispatch-table.cpp @@ -22,7 +22,8 @@ /** @file dispatch-table.cpp - ** TODO dispatch-table.cpp + ** Implementation details of render job generation. + ** @todo draft from 2011, stalled, relevance not yet clear */ diff --git a/src/proc/engine/dispatch-table.hpp b/src/proc/engine/dispatch-table.hpp index ea77b3dd1..cf34825b5 100644 --- a/src/proc/engine/dispatch-table.hpp +++ b/src/proc/engine/dispatch-table.hpp @@ -22,7 +22,8 @@ /** @file dispatch-table.hpp - ** TODO dispatch-table.hpp + ** Implementation details of render job generation. + ** @todo draft from 2011, stalled, relevance not yet clear */ diff --git a/src/proc/engine/dispatcher.cpp b/src/proc/engine/dispatcher.cpp index 1faa3b263..0c160f0f2 100644 --- a/src/proc/engine/dispatcher.cpp +++ b/src/proc/engine/dispatcher.cpp @@ -22,7 +22,8 @@ /** @file dispatcher.cpp - ** TODO dispatcher.cpp + ** Implementation parts of job generation within an ongoing render process + ** @todo valid draft, unfortunately stalled in 2013 */ @@ -39,7 +40,7 @@ namespace engine { FrameSequencer::~FrameSequencer() { } - /** */ + /** @todo WIP */ Dispatcher::JobBuilder Dispatcher::onCalcStream (ModelPort modelPort, uint channel) { @@ -48,7 +49,7 @@ namespace engine { } - /** */ + /** @todo WIP */ FrameCoord Dispatcher::JobBuilder::relativeFrameLocation (TimeAnchor& refPoint, FrameCnt frameOffset) { diff --git a/src/proc/engine/dispatcher.hpp b/src/proc/engine/dispatcher.hpp index 19fd1cacf..9065ad0c4 100644 --- a/src/proc/engine/dispatcher.hpp +++ b/src/proc/engine/dispatcher.hpp @@ -22,7 +22,13 @@ /** @file dispatcher.hpp - ** TODO dispatcher.hpp + ** Service abstraction within the render engine for generating render jobs. + ** On interface level, the render engine uses the notion of a [calculation stream](CalcStream) + ** to represent an ongoing rendering process. Within the _implementation_ of such a process, + ** the Dispatcher is responsible for transforming the generic setup of such a calculation stream + ** into a sequence of concrete jobs, anchored at some distinct point in time. + ** + ** @todo valid draft, unfortunately stalled in 2013 */ @@ -62,7 +68,7 @@ namespace engine { * evaluation and planning of new jobs, which can then be handed over to the Scheduler * for time-bound activation. * - * \par usage considerations + * ## usage considerations * the asynchronous and ongoing nature of the render process mandates to avoid a central * instance for operating this planning process. Instead, together with each chunk of * planned jobs we generate a continuation job, which -- on activation -- will pick up diff --git a/src/proc/engine/engine-service-mock.cpp b/src/proc/engine/engine-service-mock.cpp index d1eb8b723..258ec7200 100644 --- a/src/proc/engine/engine-service-mock.cpp +++ b/src/proc/engine/engine-service-mock.cpp @@ -22,7 +22,8 @@ /** @file engine-service-mock.cpp - ** TODO engine-service-mock.cpp + ** Implementation translation unit for a mock render engine for unit testing. + ** @todo draft from 2012, and, while stalled, still relevant as of 2016 */ diff --git a/src/proc/engine/engine-service.cpp b/src/proc/engine/engine-service.cpp index 78d470a24..b63f02c38 100644 --- a/src/proc/engine/engine-service.cpp +++ b/src/proc/engine/engine-service.cpp @@ -22,7 +22,7 @@ /** @file engine-service.cpp - ** TODO engine-service.cpp + ** Implementation parts related to the engine service abstraction */ diff --git a/src/proc/engine/engine-service.hpp b/src/proc/engine/engine-service.hpp index 2d7a40707..48de36ba6 100644 --- a/src/proc/engine/engine-service.hpp +++ b/src/proc/engine/engine-service.hpp @@ -34,11 +34,12 @@ ** these jobs are to be executed through the scheduler in the backend layer. ** ** While the individual CalcStram is simple, linear and unmodifiable, any CalcStream may be - ** \em superseded by a new definition. In this case, the engine will care for a seamless + ** _superseded_ by a new definition. In this case, the engine will care for a seamless ** switch and continuation; under the hood, there is a mechanism to discard resources ** tied to the original CalcStream, once the switch to the new definition is complete. ** ** @ingroup engine + ** @todo draft from 2013, stalled, but still relevant and to be continued eventually ** @see EngineInterface_test ** @see CalcStream_test ** @see proc::play::PlayerService @@ -175,6 +176,5 @@ namespace engine{ -} // namespace engine -} // namespace proc -#endif +}} // namespace proc::engine +#endif /*PROC_ENGINE_ENGINE_SERVICE_H*/ diff --git a/src/proc/engine/frame-coord.hpp b/src/proc/engine/frame-coord.hpp index 75302d2ef..cc6f5a940 100644 --- a/src/proc/engine/frame-coord.hpp +++ b/src/proc/engine/frame-coord.hpp @@ -22,7 +22,7 @@ /** @file frame-coord.hpp - ** TODO frame-coord.hpp + ** Tuple data type to address distinct frames within the render engine calculations. */ @@ -101,8 +101,8 @@ namespace engine { * This interface describes the essence of generating * a series of frame locations, which is necessary for * planning render jobs. To implement it, actually some - * kind of \link lib::time::Quantiser frame grid \endlink - * is necessary -- in practice we use a Dispatcher, which is + * kind of [frame grid](\ref lib::time::Quantiser) is + * necessary -- in practice we use a Dispatcher, which is * backed by the Segmentation (i.e. the render nodes network). */ class FrameSequencer diff --git a/src/proc/engine/job-ticket.hpp b/src/proc/engine/job-ticket.hpp index 8a0c79b23..25330979a 100644 --- a/src/proc/engine/job-ticket.hpp +++ b/src/proc/engine/job-ticket.hpp @@ -22,7 +22,10 @@ /** @file job-ticket.hpp - ** TODO job-ticket.hpp + ** Execution plan to generate render jobs within a specific render process. + ** A JobTicket is a preconfigured generator for render jobs, which in turn + ** are functors to perform the calculations for a specific data frame. + ** @see job.hpp */ @@ -74,7 +77,7 @@ using util::isnil; * To turn a JobTicket into an actual job, we need the additional information * regarding the precise frame number (=nominal time) and the channel number * to calculate (in case the actual feed is multichannel, which is the default). - * This way, the JobTicket acts as higher order function: a function + * This way, the JobTicket acts as _higher order function:_ a function * generating on invocation another, specific function (= the job). * * @todo 1/12 WIP-WIP-WIP defining the invocation sequence and render jobs @@ -236,8 +239,8 @@ using util::isnil; JobTicket::startExploration() const { UNIMPLEMENTED ("somehow build a self-referential pseudo-prerequisite, and seed an ExplorationState with that"); - /////////////////////TODO problem is: we need an JobTicket::Prerequisite instance, where the descriptor points to "self" (this JobTicket) - /////////////////////TODO : but this instance needs to reside somewhere at a safe location, since we want to embed an LinkedElements-iterator + /////////////////////TODO problem is: we need a JobTicket::Prerequisite instance, where the descriptor points to "self" (this JobTicket) + /////////////////////TODO : but this instance needs to reside somewhere at a safe location, since we want to embed a LinkedElements-iterator /////////////////////TODO : into the ExplorationState. And obviously we do not want that instance in each JobTicket, only in the top level ones /////////////////////TODO : on second thought -- better have a top-level entry point to the evaluation of a frame diff --git a/src/proc/engine/link.cpp b/src/proc/engine/link.cpp deleted file mode 100644 index 3e5a1f3ff..000000000 --- a/src/proc/engine/link.cpp +++ /dev/null @@ -1,40 +0,0 @@ -/* - Link - forwarding, adapting or connecting ProcNode - - Copyright (C) Lumiera.org - 2008, Hermann Vosseler - - 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 link.cpp - ** TODO link.cpp - */ - - -#include "proc/engine/link.hpp" - -namespace proc { -namespace engine - { - - /** */ - - - - - }} // namespace engine diff --git a/src/proc/engine/link.hpp b/src/proc/engine/link.hpp deleted file mode 100644 index 492796564..000000000 --- a/src/proc/engine/link.hpp +++ /dev/null @@ -1,59 +0,0 @@ -/* - LINK.hpp - forwarding, adapting or connecting ProcNode - - Copyright (C) Lumiera.org - 2008, Hermann Vosseler - - 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 link.hpp - ** TODO link.hpp - */ - - -#ifndef ENGINE_LINK_H -#define ENGINE_LINK_H - -#include "proc/engine/procnode.hpp" - - - -namespace proc { -namespace engine { - - - /** - * Abstraction of all sorts of connecting Elements with - * special functionality. For example the coneections enabling - * to mix OpenGL implemented Effects/Previews with normal CPU based - * processing in one render pipeline. - */ - class Link : public ProcNode - { - Link (WiringDescriptor const& wd) - : ProcNode(wd) - { } - - ///////TODO: flatten hierarchy if we don't have common functionallity for all Link-Subclasses - ///////TODO: can be decdiede when we know more how to handle OpenGL rendering - }; - - - -}} // namespace proc::engine -#endif diff --git a/src/proc/engine/mask.cpp b/src/proc/engine/mask.cpp index 46ef510e8..bb9750b61 100644 --- a/src/proc/engine/mask.cpp +++ b/src/proc/engine/mask.cpp @@ -22,18 +22,26 @@ /** @file mask.cpp - ** TODO mask.cpp + ** Mask generator node implementation + ** @deprecated not clear if needed as of 2016 */ +#include "lib/error.hpp" #include "proc/engine/mask.hpp" namespace proc { namespace engine { - + + + Mask::Mask (WiringDescriptor const& wd) + : ProcNode(wd) + { + UNIMPLEMENTED("do we need a dedicated ProcNode subclass as mask generator?"); + } + /** */ - - - - -}} // namespace engine + + + +}}// namespace engine diff --git a/src/proc/engine/mask.hpp b/src/proc/engine/mask.hpp index 46e52202d..53637619d 100644 --- a/src/proc/engine/mask.hpp +++ b/src/proc/engine/mask.hpp @@ -22,27 +22,33 @@ /** @file mask.hpp - ** TODO mask.hpp + ** Specialised render node for generating mask (alpha channel) data. + ** @todo this file is there since the very first code generation steps at start + ** of the Lumiera project. It never became clear if a mask generator would + ** need to be a dedicated ProcNode subclass; but in fact the project did + ** not reach the point of implementing anything regarding that topic. */ -#ifndef ENGINE_MASK_H -#define ENGINE_MASK_H +#ifndef PROC_ENGINE_MASK_H +#define PROC_ENGINE_MASK_H #include "proc/engine/procnode.hpp" namespace proc { -namespace engine - { - - - class Mask : public ProcNode - {}; - - - - +namespace engine{ + + + class Mask + : public ProcNode + { + public: + Mask (WiringDescriptor const&); + }; + + + }} // namespace proc::engine -#endif +#endif /*PROC_ENGINE_MASK_H*/ diff --git a/src/proc/engine/nodeinvocation.hpp b/src/proc/engine/nodeinvocation.hpp index 18f1bb75e..196ddebeb 100644 --- a/src/proc/engine/nodeinvocation.hpp +++ b/src/proc/engine/nodeinvocation.hpp @@ -35,13 +35,15 @@ ** Invocation object (a sub-interface of StateAdapter) to access the various aspects of the ** invocation state. ** - ** \par composition of the Invocation State + ** ## composition of the Invocation State + ** ** For each individual ProcNode#pull() call, the WiringAdapter#callDown() builds an StateAdapter ** instance directly on the stack, managing the actual buffer pointers and state references. Using this ** StateAdapter, the predecessor nodes are pulled. The way these operations are carried out is encoded ** in the actual StateAdapter type known to the NodeWiring (WiringAdapter) instance. All of these actual ** StateAdapter types are built as implementing the engine::State interface. - ** + ** + ** @todo relies still on an [obsoleted implementation draft](\ref bufftable-obsolete.hpp) ** @see engine::ProcNode ** @see engine::StateProxy ** @see engine::BuffTable diff --git a/src/proc/engine/source.cpp b/src/proc/engine/source.cpp index d4f597609..d63ab9a72 100644 --- a/src/proc/engine/source.cpp +++ b/src/proc/engine/source.cpp @@ -22,19 +22,21 @@ /** @file source.cpp - ** TODO source.cpp + ** Implementation of a source media reading render node. */ #include "proc/engine/source.hpp" namespace proc { -namespace engine - { - +namespace engine { + + Source::Source (WiringDescriptor const& wd) + : ProcNode(wd) + { } + /** */ - - - - + + + }} // namespace engine diff --git a/src/proc/engine/source.hpp b/src/proc/engine/source.hpp index 9fbe24721..134d73595 100644 --- a/src/proc/engine/source.hpp +++ b/src/proc/engine/source.hpp @@ -22,7 +22,14 @@ /** @file source.hpp - ** TODO source.hpp + ** Processing node to read media data. + ** The render engine node network is activated by _"pulling"_ from the _exit nodes._ + ** Recursively, any rendering calculations will eventually hit a engine::Source node, + ** to retrieve existing (raw) media data + ** @todo this file is there since the very first code generation steps at start + ** of the Lumiera project. It is not yet clear if those source reading nodes + ** will indeed be ProcNode subclasses, or rather specifically configured + ** processing nodes... */ diff --git a/src/proc/engine/worker/dummy-image-generator.cpp b/src/proc/engine/worker/dummy-image-generator.cpp index 5b29372dc..e08c13d6a 100644 --- a/src/proc/engine/worker/dummy-image-generator.cpp +++ b/src/proc/engine/worker/dummy-image-generator.cpp @@ -23,7 +23,8 @@ /** @file dummy-image-generator.cpp - ** TODO dummy-image-generator.cpp + ** Implementation of a generator for dummy video frames for a mockup + ** @todo obsolete since 2010, can be removed once we have a real player in the UI */ diff --git a/src/proc/engine/worker/dummy-image-generator.hpp b/src/proc/engine/worker/dummy-image-generator.hpp index e364423ef..c9c00315f 100644 --- a/src/proc/engine/worker/dummy-image-generator.hpp +++ b/src/proc/engine/worker/dummy-image-generator.hpp @@ -29,6 +29,7 @@ ** by Joel within PlaybackController, then factored out into a separate ** dummy playback service. ** + ** @todo obsolete since 2010, can be removed once we have a real player in the UI ** @see gui::controller::PlaybackController ** @see proc::play::DummyPlayerService ** From 846e9af174ca0bbd95022577da09b0f661514324 Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Wed, 9 Nov 2016 19:50:16 +0100 Subject: [PATCH 17/26] Doxygen: fill in missing file level headlines for Proc-Layer (Engine II) --- src/proc/engine/nodefactory.cpp | 12 +++-- src/proc/engine/nodefactory.hpp | 7 ++- src/proc/engine/nodewiring.cpp | 3 +- src/proc/engine/nodewiring.hpp | 3 +- src/proc/engine/pluginadapter.cpp | 39 -------------- src/proc/engine/pluginadapter.hpp | 54 ------------------- src/proc/engine/render-invocation.cpp | 4 +- src/proc/engine/render-invocation.hpp | 6 ++- src/proc/engine/renderengine.cpp | 10 +++- src/proc/engine/renderengine.hpp | 23 ++++---- src/proc/engine/rendergraph.cpp | 2 +- src/proc/engine/rendergraph.hpp | 8 +-- src/proc/engine/stateproxy.cpp | 3 +- src/proc/engine/stateproxy.hpp | 9 +++- src/proc/engine/time-anchor.hpp | 11 +++- .../engine/tracking-heap-block-provider.cpp | 2 +- 16 files changed, 72 insertions(+), 124 deletions(-) delete mode 100644 src/proc/engine/pluginadapter.cpp delete mode 100644 src/proc/engine/pluginadapter.hpp diff --git a/src/proc/engine/nodefactory.cpp b/src/proc/engine/nodefactory.cpp index 2b38e4603..d36dfff2c 100644 --- a/src/proc/engine/nodefactory.cpp +++ b/src/proc/engine/nodefactory.cpp @@ -1,5 +1,5 @@ /* - NodeFactory - Interface for creating processing nodes of various kinds + NodeFactory - Service for creating processing nodes of various kinds Copyright (C) Lumiera.org 2008, Hermann Vosseler @@ -22,7 +22,10 @@ /** @file nodefactory.cpp - ** TODO nodefactory.cpp + ** Implementation of render node setup and wiring + ** @todo draft from the early days of the Lumiera project, reworked in 2009 + ** Development activity in that area as stalled ever since. In the end, + ** it is highly likely we'll _indeed need_ a node factory though... */ @@ -46,7 +49,10 @@ namespace engine { using mobject::session::Effect; - /** create a processing node able to render an effect */ + /** create a processing node able to render an effect + * @todo as of 2016 this is the only (placeholder) implementation + * to indicate how building and wiring of nodes was meant to happen + */ PNode NodeFactory::operator() (Placement const& effect, WiringSituation& intendedWiring) { diff --git a/src/proc/engine/nodefactory.hpp b/src/proc/engine/nodefactory.hpp index cfcef40a7..5782a898b 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 various kinds + NODEFACTORY.hpp - Service for creating processing nodes of various kinds Copyright (C) Lumiera.org 2008, Hermann Vosseler @@ -22,7 +22,10 @@ /** @file nodefactory.hpp - ** TODO nodefactory.hpp + ** A factory to build processing nodes + ** @todo draft from the early days of the Lumiera project, reworked in 2009 + ** Development activity in that area as stalled ever since. In the end, + ** it is highly likely we'll _indeed need_ a node factory though... */ diff --git a/src/proc/engine/nodewiring.cpp b/src/proc/engine/nodewiring.cpp index bcbf10356..7a837352e 100644 --- a/src/proc/engine/nodewiring.cpp +++ b/src/proc/engine/nodewiring.cpp @@ -22,7 +22,8 @@ /** @file nodewiring.cpp - ** TODO nodewiring.cpp + ** Implementation of node wiring to build a render node network + ** @todo unfinished draft from 2009 regarding the render process */ diff --git a/src/proc/engine/nodewiring.hpp b/src/proc/engine/nodewiring.hpp index 52f073065..55ee9d176 100644 --- a/src/proc/engine/nodewiring.hpp +++ b/src/proc/engine/nodewiring.hpp @@ -22,7 +22,8 @@ /** @file nodewiring.hpp - ** TODO nodewiring.hpp + ** Mechanism to wire ProcNode instances for a render network + ** @todo unfinished draft from 2009 regarding the render process */ diff --git a/src/proc/engine/pluginadapter.cpp b/src/proc/engine/pluginadapter.cpp deleted file mode 100644 index a71a075fc..000000000 --- a/src/proc/engine/pluginadapter.cpp +++ /dev/null @@ -1,39 +0,0 @@ -/* - PluginAdapter - Adapter for integrating various Effect processors in the render pipeline - - Copyright (C) Lumiera.org - 2008, Hermann Vosseler - - 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 pluginadapter.cpp - ** TODO pluginadapter.cpp - */ - - -#include "proc/engine/pluginadapter.hpp" - -namespace proc { -namespace engine { - - /** */ - - - - -}} // namespace engine diff --git a/src/proc/engine/pluginadapter.hpp b/src/proc/engine/pluginadapter.hpp deleted file mode 100644 index cd3b6e348..000000000 --- a/src/proc/engine/pluginadapter.hpp +++ /dev/null @@ -1,54 +0,0 @@ -/* - PLUGINADAPTER.hpp - Adapter for integrating various Effect processors in the render pipeline - - Copyright (C) Lumiera.org - 2008, Hermann Vosseler - - 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 pluginadapter.hpp - ** TODO pluginadapter.hpp - */ - - -#ifndef ENGINE_PLUGINADAPTER_H -#define ENGINE_PLUGINADAPTER_H - -#include "proc/engine/procnode.hpp" - - - -namespace proc { -namespace engine - { - - - /** - * Adapter used to integrate an effects processor in the render pipeline. - * Effects processors are typically defined in a separate library and - * will be loaded at runtime using Lumiera's plugin interface. - */ - class PluginAdapter : public ProcNode - { - ///////////// - }; - - - -}} // namespace proc::engine -#endif diff --git a/src/proc/engine/render-invocation.cpp b/src/proc/engine/render-invocation.cpp index 7930b0da0..8e0a39c86 100644 --- a/src/proc/engine/render-invocation.cpp +++ b/src/proc/engine/render-invocation.cpp @@ -22,7 +22,9 @@ /** @file render-invocation.cpp - ** TODO render-invocation.cpp + ** Implementation details regarding the invocation of a single render node + ** @deprecated very likely to happen in a different way, while the concept remains valid + ** @todo unfinished draft from 2009 regarding the render process */ diff --git a/src/proc/engine/render-invocation.hpp b/src/proc/engine/render-invocation.hpp index deb2b27f7..8e3ae256e 100644 --- a/src/proc/engine/render-invocation.hpp +++ b/src/proc/engine/render-invocation.hpp @@ -23,7 +23,9 @@ /** @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. - ** + ** + ** @todo unfinished draft from 2009 regarding the render process + ** ** @see engine::ProcNode ** @see State ** @see node-basic-test.cpp @@ -47,7 +49,7 @@ namespace engine { /** - * TODO: type comment + * @todo write type comment */ class RenderInvocation { diff --git a/src/proc/engine/renderengine.cpp b/src/proc/engine/renderengine.cpp index 13867c77e..8cbdb7e21 100644 --- a/src/proc/engine/renderengine.cpp +++ b/src/proc/engine/renderengine.cpp @@ -22,16 +22,24 @@ /** @file renderengine.cpp - ** TODO renderengine.cpp + ** @deprecated a pile of crap, leftovers and started drafts, stalled since 2011 -- but maybe here to stay... */ +#include "lib/error.hpp" #include "proc/engine/renderengine.hpp" namespace proc { namespace engine { + RenderEngine::RenderEngine() + : RenderGraph() + { + UNIMPLEMENTED("wtf... a video editor without implemented render engine??"); + } + + /** */ diff --git a/src/proc/engine/renderengine.hpp b/src/proc/engine/renderengine.hpp index e3d30e480..ed533afdd 100644 --- a/src/proc/engine/renderengine.hpp +++ b/src/proc/engine/renderengine.hpp @@ -22,19 +22,19 @@ /** @file renderengine.hpp - ** TODO renderengine.hpp + ** (Planned) access point to the render engine as service. + ** @deprecated a pile of crap, leftovers and started drafts, stalled since 2011 -- but maybe here to stay... */ -#ifndef ENGINE_RENDERENGINE_H -#define ENGINE_RENDERENGINE_H - -#include +#ifndef PROC_ENGINE_RENDERENGINE_H +#define PROC_ENGINE_RENDERENGINE_H #include "proc/engine/rendergraph.hpp" +#include + -using std::list; /////////////////////////////TODO 7/11 this is a piece of debris, left over from the first attempt to complete the render nodes network. /////////////////////////////TODO Meanwhile the intention is to treat the render nodes network more like a data structure, @@ -45,20 +45,23 @@ using std::list; namespace proc { namespace engine { + using std::list; /** - * @todo this is planned to become the frontend + * @todo this was planned to become the frontend * to the render node network, which can be considered * at the lower end of the middle layer; the actual * render operations are mostly implemented by the backend * ////////TODO WIP as of 12/2010 */ - class RenderEngine : public RenderGraph + class RenderEngine + : public RenderGraph { public: ///// TODO: find out about the public operations // note: the play controller lives in the proc-layer, - // but is a subsystem separate of the sesison. + // but is a subsystem separate of the session. + RenderEngine(); private: list renderSegments; @@ -66,4 +69,4 @@ namespace engine { }; }} // namespace proc::engine -#endif +#endif /*PROC_ENGINE_RENDERENGINE_H*/ diff --git a/src/proc/engine/rendergraph.cpp b/src/proc/engine/rendergraph.cpp index a5ec10120..b04f6686f 100644 --- a/src/proc/engine/rendergraph.cpp +++ b/src/proc/engine/rendergraph.cpp @@ -22,7 +22,7 @@ /** @file rendergraph.cpp - ** TODO rendergraph.cpp + ** @deprecated a pile of crap, leftovers and started drafts, stalled since 2011 -- but maybe here to stay... */ diff --git a/src/proc/engine/rendergraph.hpp b/src/proc/engine/rendergraph.hpp index 69ff271d4..50fe228de 100644 --- a/src/proc/engine/rendergraph.hpp +++ b/src/proc/engine/rendergraph.hpp @@ -22,12 +22,12 @@ /** @file rendergraph.hpp - ** TODO rendergraph.hpp + ** @deprecated a pile of crap, leftovers and started drafts, stalled since 2011 -- but maybe here to stay... */ -#ifndef ENGINE_RENDERGRAPH_H -#define ENGINE_RENDERGRAPH_H +#ifndef PROC_ENGINE_RENDERGRAPH_H +#define PROC_ENGINE_RENDERGRAPH_H #include "proc/common.hpp" #include "proc/state.hpp" @@ -71,4 +71,4 @@ namespace engine { }} // namespace proc::engine -#endif +#endif /*PROC_ENGINE_RENDERGRAPH_H*/ diff --git a/src/proc/engine/stateproxy.cpp b/src/proc/engine/stateproxy.cpp index 2c265ec4c..9fed46358 100644 --- a/src/proc/engine/stateproxy.cpp +++ b/src/proc/engine/stateproxy.cpp @@ -22,7 +22,8 @@ /** @file stateproxy.cpp - ** TODO stateproxy.cpp + ** Implementation details of some stateful operations needed from within the render calculation. + ** @todo unfinished draft from 2009 regarding the render process */ diff --git a/src/proc/engine/stateproxy.hpp b/src/proc/engine/stateproxy.hpp index 7a623100b..99fc5319b 100644 --- a/src/proc/engine/stateproxy.hpp +++ b/src/proc/engine/stateproxy.hpp @@ -22,7 +22,14 @@ /** @file stateproxy.hpp - ** TODO stateproxy.hpp + ** Access point to the state of a frame rendering evaluation. + ** The rendering of frames is triggered from a render job, and recursively + ** retrieves the data from predecessor nodes. Some statefull aspects are involved + ** into this recursive evaluation, beyond the data in the local call stack. Such + ** additional statefull dependencies are problematic (regarding concurrency and + ** throughput) and are thus abstracted from the actual processing operations + ** with the help of the proc::engine::State interface + ** @todo unfinished draft from 2009 regarding the render process */ diff --git a/src/proc/engine/time-anchor.hpp b/src/proc/engine/time-anchor.hpp index 291dd9e5c..211f8860f 100644 --- a/src/proc/engine/time-anchor.hpp +++ b/src/proc/engine/time-anchor.hpp @@ -22,7 +22,14 @@ /** @file time-anchor.hpp - ** TODO time-anchor.hpp + ** Representation of a _continuation point_ for planning the render process. + ** In the Lumiera engine, render and playback processes are modelled as infinite streams, + ** which are evaluated chunk wise. The TimeAnchor is used to mark a point, where the + ** _planning_ of further render jobs will be picked up and continued later on + ** + ** @todo this is part of an implementation draft from 2013, + ** to create a complete outline of player and render job generation. + ** @todo as of 2016 this effort is stalled, but remains valid */ @@ -62,7 +69,7 @@ namespace engine { * the TimeAnchor closure is the definitive binding between the abstract logical time of the * session timeline, and the real wall-clock time forming the deadline for rendering. * - * \par internals + * ## internals * The time anchor associates a nominal time, defined on the implicit time grid * of some given Timings, with an actual wall clock time. Due to the usage situation, * the TimeAnchor takes on the secondary meaning of a breaking point; everything \em before diff --git a/src/proc/engine/tracking-heap-block-provider.cpp b/src/proc/engine/tracking-heap-block-provider.cpp index 509ba7977..d3c8a885a 100644 --- a/src/proc/engine/tracking-heap-block-provider.cpp +++ b/src/proc/engine/tracking-heap-block-provider.cpp @@ -22,7 +22,7 @@ /** @file tracking-heap-block-provider.cpp - ** TODO tracking-heap-block-provider.cpp + ** Implementation details of a mock engine::BufferProvider for unit testing */ From bb139a5c73a690f79e0ec75d1ff6ad63ef774ba4 Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Wed, 9 Nov 2016 20:09:19 +0100 Subject: [PATCH 18/26] Doxygen: fill in missing file level headlines for some supplemental code --- .../control/{mediaimpllib.hpp => media-impl-lib.hpp} | 10 +++++----- src/proc/external/libgavl.cpp | 7 ++++--- src/proc/external/libgavl.hpp | 9 +++++++-- src/tool/alsa.c | 2 +- src/tool/alsa.h | 1 + src/tool/hello.c | 2 +- src/tool/main.c | 5 ++++- src/tool/rsvg-convert.c | 5 ++++- 8 files changed, 27 insertions(+), 14 deletions(-) rename src/proc/control/{mediaimpllib.hpp => media-impl-lib.hpp} (89%) diff --git a/src/proc/control/mediaimpllib.hpp b/src/proc/control/media-impl-lib.hpp similarity index 89% rename from src/proc/control/mediaimpllib.hpp rename to src/proc/control/media-impl-lib.hpp index cf60e101d..08496ca30 100644 --- a/src/proc/control/mediaimpllib.hpp +++ b/src/proc/control/media-impl-lib.hpp @@ -1,5 +1,5 @@ /* - MEDIAIMPLLIB.hpp - interface providing a facade to an media handling library + MEDIA-IMPL-LIB.hpp - facade interface to access an external media handling library Copyright (C) Lumiera.org 2008, Hermann Vosseler @@ -21,7 +21,7 @@ */ -/** @file mediaimpllib.hpp +/** @file media-impl-lib.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) @@ -33,8 +33,8 @@ */ -#ifndef CONTROL_MEDIAIMPLLIB_H -#define CONTROL_MEDIAIMPLLIB_H +#ifndef PROC_CONTROL_MEDIA_IMPL_LIB_H +#define PROC_CONTROL_MEDIA_IMPL_LIB_H #include "proc/streamtype.hpp" @@ -64,4 +64,4 @@ namespace control { }} // namespace proc::control -#endif +#endif /*PROC_CONTROL_MEDIA_IMPL_LIB_H*/ diff --git a/src/proc/external/libgavl.cpp b/src/proc/external/libgavl.cpp index 892869435..99864d482 100644 --- a/src/proc/external/libgavl.cpp +++ b/src/proc/external/libgavl.cpp @@ -22,7 +22,8 @@ /** @file libgavl.cpp - ** TODO libgavl.cpp + ** Implementation details of using the GAVL library for processing + ** @todo 2016 evaluate if libGAVL is still active and maintained */ @@ -57,9 +58,9 @@ namespace external { /** * Use an type information struct, which actually has to be - * a GAVL frametype (TODO), to wire up an ImplFacade such + * a GAVL frame type (TODO), to wire up an ImplFacade such * as to deal with GAVL data frames of this type. - * @todo fill in the acutal GAVL frame type + * @todo fill in the actual GAVL frame type * @todo how to distinguish the audio and the video case? */ ImplFacadeGAVL const& diff --git a/src/proc/external/libgavl.hpp b/src/proc/external/libgavl.hpp index b16da7e27..1189c0abb 100644 --- a/src/proc/external/libgavl.hpp +++ b/src/proc/external/libgavl.hpp @@ -22,7 +22,11 @@ /** @file libgavl.hpp - ** TODO libgavl.hpp + ** Concrete implementation of the MediaImplLib facade to work with `libGAVL` + ** @todo a draft and placeholder code from 2008, at which time the intention was + ** to rely on libGAVL for processing of raw media data. This seemed like a + ** good idea at that time, but we should re-evaluate if libGAVL is maintained + ** and in actual use, before we start really relying on it */ @@ -30,7 +34,7 @@ #define PROC_EXTERNAL_LIBGAVL_H -#include "proc/control/mediaimpllib.hpp" +#include "proc/control/media-impl-lib.hpp" @@ -52,6 +56,7 @@ namespace external { * in an implementation agnostic way. * @note GAVL types are automagically registered into the * control::STypeManager on reset and thus are always available. + * @todo 2016 evaluate if libGAVL is still active and maintained */ class ImplFacadeGAVL : public ImplFacade diff --git a/src/tool/alsa.c b/src/tool/alsa.c index 738a95a8e..83cd839c7 100644 --- a/src/tool/alsa.c +++ b/src/tool/alsa.c @@ -22,7 +22,7 @@ /** @file alsa.c - ** TODO alsa.c + ** Example implementation how to access the ALSA sound backend */ diff --git a/src/tool/alsa.h b/src/tool/alsa.h index 30fdb75f7..082ed8388 100644 --- a/src/tool/alsa.h +++ b/src/tool/alsa.h @@ -22,6 +22,7 @@ /** @file alsa.h ** Interfacing to ALSA sound output. + ** @remarks Example implementation from 2011 ** ** @todo for now this header defines some functions used for experimentation with ALSA ** diff --git a/src/tool/hello.c b/src/tool/hello.c index 6de1b0003..471efc0c9 100644 --- a/src/tool/hello.c +++ b/src/tool/hello.c @@ -5,7 +5,7 @@ /** @file hello.c - ** TODO hello.c + ** Example file to demonstrate integration of stand-alone tools into the build process */ #include diff --git a/src/tool/main.c b/src/tool/main.c index 7887362c8..d0e096b64 100644 --- a/src/tool/main.c +++ b/src/tool/main.c @@ -22,7 +22,10 @@ /** @file main.c - ** TODO main.c + ** A stand alone application to test integration with output frameworks + ** @remarks the plan was to evolve this into a command line tool eventually, + ** which would use Lumiera's backend functionality to setup and probe + ** the operation environment for diagnostic purpose */ diff --git a/src/tool/rsvg-convert.c b/src/tool/rsvg-convert.c index 46a21dc78..0bcb905ac 100644 --- a/src/tool/rsvg-convert.c +++ b/src/tool/rsvg-convert.c @@ -25,7 +25,10 @@ /** @file rsvg-convert.c - ** TODO rsvg-convert.c + ** Invoke the rSVG library to render SVG vector graphics with the help of Cairo. + ** @note This tool is tightly integrated into the Lumiera build process in order + ** to render icons and UI decorations designed as vector graphics, for those + ** cases where it is beneficial to use bitmap graphics within the UI toolkit. */ From 6577a392e317bc0942398fbb2972b2e0ae3f86c6 Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Wed, 9 Nov 2016 20:43:45 +0100 Subject: [PATCH 19/26] Doxygen: fill in missing file level headlines for Proc-Layer (Builder) --- src/proc/mobject/builder/assembler.cpp | 15 ++++++------ src/proc/mobject/builder/assembler.hpp | 5 ++-- src/proc/mobject/builder/common.hpp | 3 ++- src/proc/mobject/builder/conmanager.cpp | 11 +++++---- src/proc/mobject/builder/conmanager.hpp | 8 +++---- src/proc/mobject/builder/mould.hpp | 24 ++++++++++++------- src/proc/mobject/builder/nodecreatortool.cpp | 8 ++++++- src/proc/mobject/builder/nodecreatortool.hpp | 5 ++-- src/proc/mobject/builder/operationpoint.cpp | 3 ++- src/proc/mobject/builder/operationpoint.hpp | 11 +++++++-- src/proc/mobject/builder/renderstate.hpp | 10 +++++--- .../mobject/builder/segmentation-tool.cpp | 3 ++- .../mobject/builder/segmentation-tool.hpp | 9 +++++-- src/proc/mobject/builder/toolfactory.cpp | 3 ++- src/proc/mobject/builder/toolfactory.hpp | 6 ++++- src/proc/mobject/builder/wiringrequest.hpp | 7 +++++- 16 files changed, 88 insertions(+), 43 deletions(-) diff --git a/src/proc/mobject/builder/assembler.cpp b/src/proc/mobject/builder/assembler.cpp index fc3fbe631..4bce7ad07 100644 --- a/src/proc/mobject/builder/assembler.cpp +++ b/src/proc/mobject/builder/assembler.cpp @@ -22,23 +22,24 @@ /** @file assembler.cpp - ** TODO assembler.cpp + ** @todo initially generated code of unclear relevance */ +#include "lib/error.hpp" #include "proc/mobject/builder/assembler.hpp" namespace proc { namespace mobject { namespace builder { - - - + + engine::RenderEngine & Assembler::build () { + UNIMPLEMENTED ("the builder..."); } - - - + + + }}} // namespace proc::mobject::builder diff --git a/src/proc/mobject/builder/assembler.hpp b/src/proc/mobject/builder/assembler.hpp index 054a10963..404df7560 100644 --- a/src/proc/mobject/builder/assembler.hpp +++ b/src/proc/mobject/builder/assembler.hpp @@ -22,7 +22,7 @@ /** @file assembler.hpp - ** TODO assembler.hpp + ** @todo initially generated code of unclear relevance */ @@ -45,7 +45,8 @@ namespace builder { class Assembler { public: - engine::RenderEngine & build () ; + engine::RenderEngine& + build (); // TODO: allocation, GC??? }; diff --git a/src/proc/mobject/builder/common.hpp b/src/proc/mobject/builder/common.hpp index c2d4e74e1..ff303344b 100644 --- a/src/proc/mobject/builder/common.hpp +++ b/src/proc/mobject/builder/common.hpp @@ -22,7 +22,8 @@ /** @file common.hpp - ** TODO common.hpp + ** @todo initially generated code of unclear relevance + ** @deprecated 2016 is a common inclusion file really such a good idea? */ diff --git a/src/proc/mobject/builder/conmanager.cpp b/src/proc/mobject/builder/conmanager.cpp index f08e769c2..01941e5b3 100644 --- a/src/proc/mobject/builder/conmanager.cpp +++ b/src/proc/mobject/builder/conmanager.cpp @@ -22,10 +22,11 @@ /** @file conmanager.cpp - ** TODO conmanager.cpp + ** @todo initially generated code of unclear relevance */ +#include "lib/error.hpp" #include "proc/mobject/builder/conmanager.hpp" #include "proc/control/stypemanager.hpp" @@ -36,13 +37,13 @@ namespace builder { /** - * TODO !!!!!!!!!!!!!!!!!! + * @todo TODO IT!!!!!!!!!!!!!!!!!! */ int ConManager::getConnection () { + UNIMPLEMENTED ("wiring in the builder..."); } - - - + + }}} // namespace proc::mobject::builder diff --git a/src/proc/mobject/builder/conmanager.hpp b/src/proc/mobject/builder/conmanager.hpp index ff1fa0a61..454dbd6ff 100644 --- a/src/proc/mobject/builder/conmanager.hpp +++ b/src/proc/mobject/builder/conmanager.hpp @@ -22,7 +22,7 @@ /** @file conmanager.hpp - ** TODO conmanager.hpp + ** @todo initially generated code of unclear relevance */ @@ -43,7 +43,7 @@ namespace builder { * with the corresponding ParamProviders (automation) in the Session. * Questions regarding the possibility of a media stream connection are * delegated internally to the STypeManager. - * \par + * * The primary service of the connection manager is to accept a wiring request * and handle the details of establishing the necessary connections. */ @@ -51,9 +51,9 @@ namespace builder { { public: /** - * TODO just a design sketch, work out signatures etc... + * @todo just a design sketch from 2008, work out signatures etc... */ - int getConnection () ; + int getConnection (); }; diff --git a/src/proc/mobject/builder/mould.hpp b/src/proc/mobject/builder/mould.hpp index c66af5271..371482d3b 100644 --- a/src/proc/mobject/builder/mould.hpp +++ b/src/proc/mobject/builder/mould.hpp @@ -22,7 +22,13 @@ /** @file mould.hpp - ** TODO mould.hpp + ** Builder tool kit. + ** On the basic level, the builder works by wiring up new processing nodes, + ** guided by a small number of preconfigured building patterns. For each such + ** basic wiring situation, there is a builder::Mould, which acts as a fixed + ** counterpart for the node network in construction to hinge on. + ** + ** @todo plan and draft from 2008 -- still considered relevant as of 2016 */ @@ -45,21 +51,21 @@ namespace builder { /** - * Interface: a workbench-like tool used by the builder + * Interface: a workbench-like tool used by the builder * for wiring up a specific building situation, followed by - * the application/execution of a single building step. Mould is + * 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 processing pattern to be defined as working on symbolic locations. * Most commonly this is "current", denoting the render node just being built. - *
  • PipeMould supports attaching an effect to a pipe
    • - *
  • combining pipes via a transition is done by a CombiningMould
    • - *
  • a SourceChainMould allows to start out from a source reader and build a clip
    • - *
  • wiring general connections is supported by the WiringMould
    • - *
+ * - PipeMould supports attaching an effect to a pipe + * - combining pipes via a transition is done by a CombiningMould + * - a SourceChainMould allows to start out from a source reader and build a clip + * - wiring general connections is supported by the WiringMould + * * @see ToolFactory - * @see NodeCreatorTool + * @see NodeCreatorTool */ class Mould { diff --git a/src/proc/mobject/builder/nodecreatortool.cpp b/src/proc/mobject/builder/nodecreatortool.cpp index 58c38644d..fcec1ac82 100644 --- a/src/proc/mobject/builder/nodecreatortool.cpp +++ b/src/proc/mobject/builder/nodecreatortool.cpp @@ -22,10 +22,12 @@ /** @file nodecreatortool.cpp - ** TODO nodecreatortool.cpp + ** Implementation of visitor logic to actually build the render node network + ** @todo stalled design draft from 2008 -- basically still considered relevant as of 2016 */ +#include "lib/error.hpp" #include "proc/mobject/builder/nodecreatortool.hpp" @@ -48,24 +50,28 @@ namespace builder { void NodeCreatorTool::treat (Buildable& something) { + UNIMPLEMENTED ("the builder tool..."); } void NodeCreatorTool::treat (Clip& clip) { + UNIMPLEMENTED ("the builder tool..."); } void NodeCreatorTool::treat (Effect& effect) { + UNIMPLEMENTED ("the builder tool..."); } void NodeCreatorTool::treat (Auto& automation) { + UNIMPLEMENTED ("the builder tool..."); } diff --git a/src/proc/mobject/builder/nodecreatortool.hpp b/src/proc/mobject/builder/nodecreatortool.hpp index 48686666a..a6c79045b 100644 --- a/src/proc/mobject/builder/nodecreatortool.hpp +++ b/src/proc/mobject/builder/nodecreatortool.hpp @@ -22,7 +22,8 @@ /** @file nodecreatortool.hpp - ** TODO nodecreatortool.hpp + ** Visitor tool to work on the concrete model objects when building the render node network. + ** @todo stalled design draft from 2008 -- basically still considered relevant as of 2016 */ @@ -78,4 +79,4 @@ namespace builder { }}} // namespace proc:mobject::builder -#endif +#endif /*MOBJECT_BUILDER_NODECREATORTOOL_H*/ diff --git a/src/proc/mobject/builder/operationpoint.cpp b/src/proc/mobject/builder/operationpoint.cpp index 9b118f896..b3ef74831 100644 --- a/src/proc/mobject/builder/operationpoint.cpp +++ b/src/proc/mobject/builder/operationpoint.cpp @@ -22,7 +22,8 @@ /** @file operationpoint.cpp - ** TODO operationpoint.cpp + ** Implementation of primitive builder operations on at the _current point of operation_. + ** @todo stalled design draft from 2008 -- basically still considered relevant as of 2016 */ diff --git a/src/proc/mobject/builder/operationpoint.hpp b/src/proc/mobject/builder/operationpoint.hpp index 5d076a6ce..4dd8eca0c 100644 --- a/src/proc/mobject/builder/operationpoint.hpp +++ b/src/proc/mobject/builder/operationpoint.hpp @@ -22,7 +22,14 @@ /** @file operationpoint.hpp - ** TODO operationpoint.hpp + ** Abstraction to represent the current point of operation within the builder. + ** The Builder walks the tree of the high-level-model (session model) to generate + ** a (low-level) render node network. The current point of operation within this tree walk + ** is abstracted, to allow the use of some _building primitives._ A meta description of + ** *processing patterns* can be used then to control the actual build process, without + ** the need of hard wiring the individual builder steps. + ** + ** @todo stalled design draft from 2008 -- basically still considered relevant as of 2016 */ @@ -85,4 +92,4 @@ namespace builder { }}} // namespace proc::mobject::builder -#endif +#endif /*MOBJECT_BUILDER_OPERATIONPOINT_H*/ diff --git a/src/proc/mobject/builder/renderstate.hpp b/src/proc/mobject/builder/renderstate.hpp index 48e60a226..10e9b68c1 100644 --- a/src/proc/mobject/builder/renderstate.hpp +++ b/src/proc/mobject/builder/renderstate.hpp @@ -22,7 +22,11 @@ /** @file renderstate.hpp - ** TODO renderstate.hpp + ** Build and prepare the render state abstraction. + ** The intention was to rely later, during the actual rendering, on the + ** setup prepared here + ** @deprecated stalled design draft from 2008 -- especially the part regarding RenderSate + ** will likely be implemented in a different way */ @@ -42,7 +46,7 @@ namespace builder { /** * Encapsulates the logic used to get a "render process". - * The provided StateProxy serves to hold any mutalbe state used + * The provided StateProxy serves to hold any mutable 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) @@ -56,4 +60,4 @@ namespace builder { }}} // namespace proc::mobject::session -#endif +#endif /*MOBJECT_BUILDER_RENDERSTATE_H*/ diff --git a/src/proc/mobject/builder/segmentation-tool.cpp b/src/proc/mobject/builder/segmentation-tool.cpp index c269f1e08..be65f0627 100644 --- a/src/proc/mobject/builder/segmentation-tool.cpp +++ b/src/proc/mobject/builder/segmentation-tool.cpp @@ -22,7 +22,8 @@ /** @file segmentation-tool.cpp - ** TODO segmentation-tool.cpp + ** Implementation of builder primitives to create a timeline segmentation. + ** @todo stalled design draft from 2008 -- basically still considered relevant as of 2016 */ diff --git a/src/proc/mobject/builder/segmentation-tool.hpp b/src/proc/mobject/builder/segmentation-tool.hpp index 3027fc3d2..d281f0c54 100644 --- a/src/proc/mobject/builder/segmentation-tool.hpp +++ b/src/proc/mobject/builder/segmentation-tool.hpp @@ -22,7 +22,12 @@ /** @file segmentation-tool.hpp - ** TODO segmentation-tool.hpp + ** Visiting tool to create a viable _segmentation_ of the timeline for rendering. + ** Within each such segment, the _configuration and wiring_ of the render node network + ** is considered stable. Any further variation within a segment is created solely by varying + ** parameters (automation). The created Segmentation is considered the "backbone" of the + ** low-level render node network + ** @todo stalled design draft from 2008 -- basically still considered relevant as of 2016 */ @@ -81,4 +86,4 @@ namespace builder { }}} // namespace proc::mobject::builder -#endif +#endif /*MOBJECT_BUILDER_SEGMENTATION_TOOL_H*/ diff --git a/src/proc/mobject/builder/toolfactory.cpp b/src/proc/mobject/builder/toolfactory.cpp index 17cd300ab..75f8adde9 100644 --- a/src/proc/mobject/builder/toolfactory.cpp +++ b/src/proc/mobject/builder/toolfactory.cpp @@ -22,7 +22,8 @@ /** @file toolfactory.cpp - ** TODO toolfactory.cpp + ** Implementation of factory functions for the tools used within the Builder + ** @todo stalled design draft from 2008 -- basically still considered relevant as of 2016 */ diff --git a/src/proc/mobject/builder/toolfactory.hpp b/src/proc/mobject/builder/toolfactory.hpp index e5c495872..5d325020f 100644 --- a/src/proc/mobject/builder/toolfactory.hpp +++ b/src/proc/mobject/builder/toolfactory.hpp @@ -22,7 +22,11 @@ /** @file toolfactory.hpp - ** TODO toolfactory.hpp + ** Factory to create the tools for the build process. + ** Obviously the logic to control and direct the build process will be attached + ** behind this interface. + ** + ** @todo stalled design draft from 2008 -- basically still considered relevant as of 2016 */ diff --git a/src/proc/mobject/builder/wiringrequest.hpp b/src/proc/mobject/builder/wiringrequest.hpp index 59d390648..a565a157f 100644 --- a/src/proc/mobject/builder/wiringrequest.hpp +++ b/src/proc/mobject/builder/wiringrequest.hpp @@ -22,7 +22,12 @@ /** @file wiringrequest.hpp - ** TODO wiringrequest.hpp + ** Symbolic representation of a goal for node wiring. + ** A WiringRequest is discovered while walking the Session model, and will be resolved + ** later, when the target for the desired connection is available. When all wiring requests + ** are resolved, the build process finishes. Thus, creating and resolving of such requests + ** is the "fuel" actually to drive the Builder. + ** @todo stalled design draft from 2008 -- basically still considered relevant as of 2016 */ From bfccd99623f7050757ef24d5b123f4eadd23e992 Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Wed, 9 Nov 2016 22:22:55 +0100 Subject: [PATCH 20/26] Doxygen: fill in missing file level headlines for Proc-Layer (Session) --- src/proc/mobject/session/abstractmo.cpp | 2 +- src/proc/mobject/session/abstractmo.hpp | 2 +- src/proc/mobject/session/allocation.cpp | 2 +- src/proc/mobject/session/allocation.hpp | 3 ++- src/proc/mobject/session/auto.cpp | 2 +- src/proc/mobject/session/auto.hpp | 2 +- src/proc/mobject/session/binding.cpp | 4 ++- src/proc/mobject/session/binding.hpp | 4 ++- src/proc/mobject/session/bus-mo.cpp | 4 ++- src/proc/mobject/session/bus-mo.hpp | 7 ++++- src/proc/mobject/session/clip.cpp | 16 ++++++----- src/proc/mobject/session/clip.hpp | 4 ++- src/proc/mobject/session/constraint.cpp | 2 +- src/proc/mobject/session/constraint.hpp | 3 ++- src/proc/mobject/session/effect.cpp | 4 +-- src/proc/mobject/session/effect.hpp | 2 +- src/proc/mobject/session/element-query.hpp | 5 +++- src/proc/mobject/session/fixedlocation.cpp | 3 ++- src/proc/mobject/session/fixedlocation.hpp | 8 +++++- src/proc/mobject/session/fixture.cpp | 4 ++- src/proc/mobject/session/fixture.hpp | 16 ++++++++++- src/proc/mobject/session/fork.cpp | 4 ++- src/proc/mobject/session/fork.hpp | 27 ++++++++++++++++++- src/proc/mobject/session/generator-mo.cpp | 3 ++- src/proc/mobject/session/generator-mo.hpp | 5 +++- src/proc/mobject/session/label.cpp | 2 +- src/proc/mobject/session/label.hpp | 9 ++++++- src/proc/mobject/session/locatingpin.cpp | 6 ++++- src/proc/mobject/session/meta.cpp | 5 +++- src/proc/mobject/session/meta.hpp | 4 ++- src/proc/mobject/session/mobjectfactory.cpp | 3 ++- src/proc/mobject/session/mobjectfactory.hpp | 5 +++- .../placement-index-query-resolver.cpp | 3 ++- src/proc/mobject/session/plug.cpp | 2 +- src/proc/mobject/session/plug.hpp | 4 +-- .../mobject/session/query-focus-stack.hpp | 8 +++--- src/proc/mobject/session/query-focus.cpp | 3 ++- src/proc/mobject/session/query-focus.hpp | 22 +++++++++++++-- .../session/query/fake-configrules.cpp | 14 ++++++++-- src/proc/mobject/session/relativelocation.cpp | 4 ++- src/proc/mobject/session/relativelocation.hpp | 3 ++- src/proc/mobject/session/root.cpp | 3 ++- src/proc/mobject/session/root.hpp | 10 ++++++- src/proc/mobject/session/scope-locator.hpp | 6 +++-- src/proc/mobject/session/scope-path.cpp | 3 ++- src/proc/mobject/session/scope.hpp | 3 ++- src/proc/mobject/session/segment.cpp | 3 ++- src/proc/mobject/session/segment.hpp | 4 ++- src/proc/mobject/session/segmentation.cpp | 3 ++- src/proc/mobject/session/segmentation.hpp | 9 ++++++- .../mobject/session/sess-manager-impl.cpp | 2 +- .../mobject/session/sess-manager-impl.hpp | 13 ++++++++- src/proc/mobject/session/session-impl.cpp | 4 ++- src/proc/mobject/session/session-services.cpp | 17 +++++++++++- .../session/specific-contents-query.hpp | 7 ++++- src/proc/mobject/session/wish.cpp | 2 +- src/proc/mobject/session/wish.hpp | 3 ++- 57 files changed, 257 insertions(+), 70 deletions(-) diff --git a/src/proc/mobject/session/abstractmo.cpp b/src/proc/mobject/session/abstractmo.cpp index bc00d335b..aeb4af956 100644 --- a/src/proc/mobject/session/abstractmo.cpp +++ b/src/proc/mobject/session/abstractmo.cpp @@ -22,7 +22,7 @@ /** @file abstractmo.cpp - ** TODO abstractmo.cpp + ** @todo result of the very first code generation from UML in 2008. Relevance not clear yet... */ diff --git a/src/proc/mobject/session/abstractmo.hpp b/src/proc/mobject/session/abstractmo.hpp index 986197a80..093cfaeef 100644 --- a/src/proc/mobject/session/abstractmo.hpp +++ b/src/proc/mobject/session/abstractmo.hpp @@ -22,7 +22,7 @@ /** @file abstractmo.hpp - ** TODO abstractmo.hpp + ** @todo result of the very first code generation from UML in 2008. Relevance not clear yet... */ diff --git a/src/proc/mobject/session/allocation.cpp b/src/proc/mobject/session/allocation.cpp index 8532b12f3..3e8912eb7 100644 --- a/src/proc/mobject/session/allocation.cpp +++ b/src/proc/mobject/session/allocation.cpp @@ -22,7 +22,7 @@ /** @file allocation.cpp - ** TODO allocation.cpp + ** @todo result of the very first code generation from UML in 2008. Relevance not clear yet... */ diff --git a/src/proc/mobject/session/allocation.hpp b/src/proc/mobject/session/allocation.hpp index bc94389f4..6f6881422 100644 --- a/src/proc/mobject/session/allocation.hpp +++ b/src/proc/mobject/session/allocation.hpp @@ -22,7 +22,8 @@ /** @file allocation.hpp - ** TODO allocation.hpp + ** @todo result of the very first code generation from UML in 2008. Relevance not clear yet... + ** @deprecated WTF? looks like a leftover of some early brainstorming... */ diff --git a/src/proc/mobject/session/auto.cpp b/src/proc/mobject/session/auto.cpp index 5b1032a1a..e3e0ede12 100644 --- a/src/proc/mobject/session/auto.cpp +++ b/src/proc/mobject/session/auto.cpp @@ -22,7 +22,7 @@ /** @file auto.cpp - ** TODO auto.cpp + ** @todo result of the very first code generation from UML in 2008. Relevance not clear yet... */ diff --git a/src/proc/mobject/session/auto.hpp b/src/proc/mobject/session/auto.hpp index 1f542e247..69136380b 100644 --- a/src/proc/mobject/session/auto.hpp +++ b/src/proc/mobject/session/auto.hpp @@ -22,7 +22,7 @@ /** @file auto.hpp - ** TODO auto.hpp + ** @todo result of the very first code generation from UML in 2008. Relevance not clear yet... */ diff --git a/src/proc/mobject/session/binding.cpp b/src/proc/mobject/session/binding.cpp index b116252e2..7c85195e3 100644 --- a/src/proc/mobject/session/binding.cpp +++ b/src/proc/mobject/session/binding.cpp @@ -22,7 +22,9 @@ /** @file binding.cpp - ** TODO binding.cpp + ** Implementation details of the Binding MObject to tie a sequence into a timeline or virtual clip + ** @todo stalled effort towards a session implementation from 2010 + ** @todo 2016 likely to stay, but expect some extensive rework */ diff --git a/src/proc/mobject/session/binding.hpp b/src/proc/mobject/session/binding.hpp index 928ceec6d..1d9d638dc 100644 --- a/src/proc/mobject/session/binding.hpp +++ b/src/proc/mobject/session/binding.hpp @@ -22,7 +22,9 @@ /** @file binding.hpp - ** TODO binding.hpp + ** MObject in session to represent the top-level binding of a sequence + ** @todo stalled effort towards a session implementation from 2010 + ** @todo 2016 likely to stay, but expect some extensive rework */ diff --git a/src/proc/mobject/session/bus-mo.cpp b/src/proc/mobject/session/bus-mo.cpp index 433a3f393..1f8faf21e 100644 --- a/src/proc/mobject/session/bus-mo.cpp +++ b/src/proc/mobject/session/bus-mo.cpp @@ -22,7 +22,9 @@ /** @file bus-mo.cpp - ** TODO bus-mo.cpp + ** Implementation details for a _processing pipe_ representation in the Session model + ** @todo stalled effort towards a session implementation from 2010 + ** @todo 2016 likely to stay, but expect some extensive rework */ diff --git a/src/proc/mobject/session/bus-mo.hpp b/src/proc/mobject/session/bus-mo.hpp index d00e764df..24f591539 100644 --- a/src/proc/mobject/session/bus-mo.hpp +++ b/src/proc/mobject/session/bus-mo.hpp @@ -22,7 +22,12 @@ /** @file bus-mo.hpp - ** TODO bus-mo.hpp + ** MObject in the Session to represent a processing pipe. + ** Within the Session model, Pipes are conceptual entities, which do not correspond + ** 1:1 to some render nodes, but rather help the _user_ to organise the processing steps + ** required to get some piece of the film into desired shape + ** @todo stalled effort towards a session implementation from 2010 + ** @todo 2016 likely to stay, but expect some extensive rework */ diff --git a/src/proc/mobject/session/clip.cpp b/src/proc/mobject/session/clip.cpp index 8df40ec34..1016b6df1 100644 --- a/src/proc/mobject/session/clip.cpp +++ b/src/proc/mobject/session/clip.cpp @@ -22,7 +22,9 @@ /** @file clip.cpp - ** TODO clip.cpp + ** Implementation details regarding a media clip as integrated into the edit / session model. + ** @todo stalled effort towards a session implementation from 2008 + ** @todo 2016 likely to stay, but expect some extensive rework */ @@ -43,18 +45,18 @@ 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) + Clip::Clip (asset::Clip const& clipDef, Media const& mediaDef) : mediaDef_(mediaDef) , clipDef_(clipDef) - { - setupLength(); - throwIfInvalid(); - } + { + setupLength(); + throwIfInvalid(); + } /** implementing the common MObject self test. - * Length definition is consitent, underlying + * Length definition is consistent, underlying * media def is accessible etc. */ bool Clip::isValid () const diff --git a/src/proc/mobject/session/clip.hpp b/src/proc/mobject/session/clip.hpp index 6c1f39098..bd38df1fa 100644 --- a/src/proc/mobject/session/clip.hpp +++ b/src/proc/mobject/session/clip.hpp @@ -22,7 +22,9 @@ /** @file clip.hpp - ** TODO clip.hpp + ** MObject in the Session to represent a clip on the timeline + ** @todo stalled effort towards a session implementation from 2008 + ** @todo 2016 likely to stay, but expect some extensive rework */ diff --git a/src/proc/mobject/session/constraint.cpp b/src/proc/mobject/session/constraint.cpp index b9e59aeb4..48cc7d6e4 100644 --- a/src/proc/mobject/session/constraint.cpp +++ b/src/proc/mobject/session/constraint.cpp @@ -22,7 +22,7 @@ /** @file constraint.cpp - ** TODO constraint.cpp + ** @todo result of the very first code generation from UML in 2008. Relevance not clear yet... */ diff --git a/src/proc/mobject/session/constraint.hpp b/src/proc/mobject/session/constraint.hpp index 9cdb3daee..766382064 100644 --- a/src/proc/mobject/session/constraint.hpp +++ b/src/proc/mobject/session/constraint.hpp @@ -22,7 +22,8 @@ /** @file constraint.hpp - ** TODO constraint.hpp + ** Specialised LocatingPin for use in placements + ** @todo result of the very first code generation from UML in 2008. Relevance not clear yet... */ diff --git a/src/proc/mobject/session/effect.cpp b/src/proc/mobject/session/effect.cpp index 760ac9771..f4bac6756 100644 --- a/src/proc/mobject/session/effect.cpp +++ b/src/proc/mobject/session/effect.cpp @@ -22,7 +22,7 @@ /** @file effect.cpp - ** TODO effect.cpp + ** @todo result of the very first code generation from UML in 2008. Relevance not clear yet... */ @@ -38,7 +38,7 @@ namespace session { asset::Proc const& Effect::getProcAsset() const { - UNIMPLEMENTED ("how to access the processing asset assotiated to a given Effect-MObject"); + UNIMPLEMENTED ("how to access the processing asset associated to a given Effect-MObject"); } diff --git a/src/proc/mobject/session/effect.hpp b/src/proc/mobject/session/effect.hpp index 133cf80ca..b54ed80b6 100644 --- a/src/proc/mobject/session/effect.hpp +++ b/src/proc/mobject/session/effect.hpp @@ -22,7 +22,7 @@ /** @file effect.hpp - ** TODO effect.hpp + ** @todo result of the very first code generation from UML in 2008. Relevance not clear yet... */ diff --git a/src/proc/mobject/session/element-query.hpp b/src/proc/mobject/session/element-query.hpp index e10d2f81f..132b06317 100644 --- a/src/proc/mobject/session/element-query.hpp +++ b/src/proc/mobject/session/element-query.hpp @@ -22,7 +22,10 @@ /** @file element-query.hpp - ** TODO element-query.hpp + ** Search and query services to discover contents of the session + ** + ** @todo WIP implementation of session core from 2010 + ** @todo as of 2016, this effort is considered stalled but basically valid */ diff --git a/src/proc/mobject/session/fixedlocation.cpp b/src/proc/mobject/session/fixedlocation.cpp index 115fe56d0..4cc323da2 100644 --- a/src/proc/mobject/session/fixedlocation.cpp +++ b/src/proc/mobject/session/fixedlocation.cpp @@ -22,7 +22,8 @@ /** @file fixedlocation.cpp - ** TODO fixedlocation.cpp + ** @todo stalled effort towards a session implementation from 2008 + ** @todo 2016 likely to stay, but expect some extensive rework */ diff --git a/src/proc/mobject/session/fixedlocation.hpp b/src/proc/mobject/session/fixedlocation.hpp index d19a9e587..7790a00b8 100644 --- a/src/proc/mobject/session/fixedlocation.hpp +++ b/src/proc/mobject/session/fixedlocation.hpp @@ -22,7 +22,13 @@ /** @file fixedlocation.hpp - ** TODO fixedlocation.hpp + ** Specialised LocatingPin for use in Placement, especially for globally fixed positions + ** The FixedLocation is assumed to play a central role within the Build process, which + ** ultimately aims ad resolving any part of the session into either a wiring directive + ** or a piece of media or processing to happen at a location fixed in time. + ** + ** @todo stalled effort towards a session implementation from 2008 + ** @todo 2016 likely to stay, but expect some extensive rework */ diff --git a/src/proc/mobject/session/fixture.cpp b/src/proc/mobject/session/fixture.cpp index ce2f1bcd7..70b705580 100644 --- a/src/proc/mobject/session/fixture.cpp +++ b/src/proc/mobject/session/fixture.cpp @@ -22,7 +22,9 @@ /** @file fixture.cpp - ** TODO fixture.cpp + ** Implementation of the Fixture datastructure + ** @todo WIP implementation of session core from 2010 + ** @todo as of 2016, this effort is considered stalled but basically valid */ diff --git a/src/proc/mobject/session/fixture.hpp b/src/proc/mobject/session/fixture.hpp index 06cc74617..d4b489617 100644 --- a/src/proc/mobject/session/fixture.hpp +++ b/src/proc/mobject/session/fixture.hpp @@ -22,7 +22,21 @@ /** @file fixture.hpp - ** TODO fixture.hpp + ** Backbone data structure of the low-level render node model + ** The fixture defines the boundary between the Session (high-level) realm + ** and the internals of the render engine. The goal of a Builder run is to + ** build a new Fixture. All relative or indirect referrals are resolved at that point + ** and all time positions or output designations are made explicit. The Fixture defines + ** a Segmentation of every (top-level) timeline, and thus defines those segments which + ** can be rendered with a single wiring configuration. This Segmentation, as defined as + ** part of the Fixture, is also the foundation for memory management within the engine + ** model, since the allocation of render nodes for a given segment happens at once, and + ** segments are obliterated as a whole, when being replaced by a new version as result + ** of a more recent builder run. Ongoing render processes are also tracked per segment, + ** which allows the individual calculation steps just to assume the data is "there". + ** + ** @todo WIP implementation of session core from 2010 + ** @todo as of 2016, this effort is considered stalled but basically valid */ diff --git a/src/proc/mobject/session/fork.cpp b/src/proc/mobject/session/fork.cpp index 1d9a1e675..e6fd9b1ff 100644 --- a/src/proc/mobject/session/fork.cpp +++ b/src/proc/mobject/session/fork.cpp @@ -22,7 +22,9 @@ /** @file fork.cpp - ** TODO fork.cpp + ** Implementation of the basic grouping device within the session ("Track" / "Media Bin") + ** @todo WIP implementation of session core from 2010 + ** @todo as of 2016, this effort is considered stalled but basically valid */ diff --git a/src/proc/mobject/session/fork.hpp b/src/proc/mobject/session/fork.hpp index 73468e94e..01e6d93d8 100644 --- a/src/proc/mobject/session/fork.hpp +++ b/src/proc/mobject/session/fork.hpp @@ -22,7 +22,32 @@ /** @file fork.hpp - ** TODO fork.hpp + ** Organisational grouping device within the Session model ("Track" / "Media Bin"). + ** Within Lumiera, Tracks bear no direct relation to the rendering or calculation process; + ** rather they are just conceived as a space for the user to arrange the parts included + ** into the edit. + ** + ** A Fork is a nested tree-shaped structure. When integrated into a sequence, it will be + ** rendered in the familiar way, as tracks with media clips. But at the same time, when + ** accessed through the _Asset management view_ ("bookkeeping view"), a fork appears as + ** nested folder structure to hold media clips. + ** + ** Most importantly, a Fork defines a _system of nested scopes._ When discovering details + ** of the wiring, setup and configuration, the Build process will look into the enclosing + ** scope to fill in any part not defined locally at a given media object. Go give a typical + ** example, the _volume for sound playback_ can be defined in some root scope, causing all + ** sound objects to _inherit_ that volume setting -- unless shadowed by a more specialised + ** setting closer in scope to the sound object in question. This allows to set up global + ** properties and then to override them locally, for a group of objects located in some + ** sub-fork. + ** + ** @note to stress this point: in Lumiera we do _not conceive tracks as some kind of + ** channel, with media data flowing through the tracks._ Also, _tracks are not layers._ + ** This also means, there is _no distinction in audio and video tracks._ + ** We leave it at the user's discretion how she wants to organise the edit. + ** + ** @todo WIP implementation of session core from 2010 + ** @todo as of 2016, this effort is considered stalled but basically valid */ diff --git a/src/proc/mobject/session/generator-mo.cpp b/src/proc/mobject/session/generator-mo.cpp index 6e836a480..f7f56449e 100644 --- a/src/proc/mobject/session/generator-mo.cpp +++ b/src/proc/mobject/session/generator-mo.cpp @@ -22,7 +22,8 @@ /** @file generator-mo.cpp - ** TODO generator-mo.cpp + ** @todo WIP implementation of player subsystem from 2011 + ** @todo as of 2016, this effort is considered stalled but basically valid */ diff --git a/src/proc/mobject/session/generator-mo.hpp b/src/proc/mobject/session/generator-mo.hpp index 059f012e7..35bef01af 100644 --- a/src/proc/mobject/session/generator-mo.hpp +++ b/src/proc/mobject/session/generator-mo.hpp @@ -22,7 +22,10 @@ /** @file generator-mo.hpp - ** TODO generator-mo.hpp + ** A data generator media object. + ** Can be used as placeholder, or as testing device + ** @todo WIP implementation of player subsystem from 2011 + ** @todo as of 2016, this effort is considered stalled but basically valid */ diff --git a/src/proc/mobject/session/label.cpp b/src/proc/mobject/session/label.cpp index a292a9de0..c83b90d87 100644 --- a/src/proc/mobject/session/label.cpp +++ b/src/proc/mobject/session/label.cpp @@ -22,7 +22,7 @@ /** @file label.cpp - ** TODO label.cpp + ** @todo result of the very first code generation from UML in 2008. Relevance not clear yet... */ diff --git a/src/proc/mobject/session/label.hpp b/src/proc/mobject/session/label.hpp index 906cb777b..ea6b5b3a4 100644 --- a/src/proc/mobject/session/label.hpp +++ b/src/proc/mobject/session/label.hpp @@ -22,7 +22,14 @@ /** @file label.hpp - ** TODO label.hpp + ** A marker or reference point in the Session. + ** Label MObjects can be [placed](\ref Placement) at various locations and scopes, + ** e.g. on the timeline, or relative to the media data of a clip. They can be used to give + ** a visual clue for the user's orientation within the edit, or for navigation on the timeline, + ** but also as an anchor point to place other elements with relative offset. + ** + ** @todo result of the very first code generation from UML in 2008. + ** @todo this is expected to become a very important facility eventually, so expec a lot of rework here... */ diff --git a/src/proc/mobject/session/locatingpin.cpp b/src/proc/mobject/session/locatingpin.cpp index b0c29bbb3..11cfa8beb 100644 --- a/src/proc/mobject/session/locatingpin.cpp +++ b/src/proc/mobject/session/locatingpin.cpp @@ -22,7 +22,11 @@ /** @file locatingpin.cpp - ** TODO locatingpin.cpp + ** Implementation of the query resolving mechanics within a Placement. + ** All MObject entities within the session are attached via Placement, + ** and each such Placement holds a list of _constraints,_ represented as LocatingPin. + ** @todo stalled effort towards a session implementation from 2008 + ** @todo 2016 likely to stay, but expect some extensive rework */ diff --git a/src/proc/mobject/session/meta.cpp b/src/proc/mobject/session/meta.cpp index 1a14a64bc..d0891b5f0 100644 --- a/src/proc/mobject/session/meta.cpp +++ b/src/proc/mobject/session/meta.cpp @@ -22,7 +22,10 @@ /** @file meta.cpp - ** TODO meta.cpp + ** implementation details regarding the Meta asset abstraction + ** + ** @todo stalled effort towards a session implementation from 2008 + ** @todo 2016 not sure if we really need a separate translation unit for this? */ diff --git a/src/proc/mobject/session/meta.hpp b/src/proc/mobject/session/meta.hpp index c5973dbe4..0cff68e6f 100644 --- a/src/proc/mobject/session/meta.hpp +++ b/src/proc/mobject/session/meta.hpp @@ -22,7 +22,9 @@ /** @file meta.hpp - ** TODO meta.hpp + ** Intermediate Asset interface: metadata and processing instructions + ** @todo stalled effort towards a session implementation from 2008 + ** @todo 2016 likely to stay, but expect some extensive rework */ diff --git a/src/proc/mobject/session/mobjectfactory.cpp b/src/proc/mobject/session/mobjectfactory.cpp index 1941e73df..82e6bb764 100644 --- a/src/proc/mobject/session/mobjectfactory.cpp +++ b/src/proc/mobject/session/mobjectfactory.cpp @@ -22,7 +22,8 @@ /** @file mobjectfactory.cpp - ** TODO mobjectfactory.cpp + ** @todo stalled effort towards a session implementation from 2008 + ** @todo 2016 likely to stay, but expect some extensive rework */ diff --git a/src/proc/mobject/session/mobjectfactory.hpp b/src/proc/mobject/session/mobjectfactory.hpp index 16830e2d6..5edcefe3e 100644 --- a/src/proc/mobject/session/mobjectfactory.hpp +++ b/src/proc/mobject/session/mobjectfactory.hpp @@ -22,7 +22,10 @@ /** @file mobjectfactory.hpp - ** TODO mobjectfactory.hpp + ** Core factory to generate media objects for use in the Session model. + ** @todo stalled effort towards a session implementation from 2008 + ** @todo 2016 likely to stay, but expect some extensive rework. + ** In fact I am quite unhappy with the shape of this code */ diff --git a/src/proc/mobject/session/placement-index-query-resolver.cpp b/src/proc/mobject/session/placement-index-query-resolver.cpp index 8efc2606a..f7b5094e0 100644 --- a/src/proc/mobject/session/placement-index-query-resolver.cpp +++ b/src/proc/mobject/session/placement-index-query-resolver.cpp @@ -22,7 +22,8 @@ /** @file placement-index-query-resolver.cpp - ** TODO placement-index-query-resolver.cpp + ** @todo WIP implementation of session core from 2010 + ** @todo as of 2016, this effort is considered stalled but basically valid */ diff --git a/src/proc/mobject/session/plug.cpp b/src/proc/mobject/session/plug.cpp index d6b05b451..0b6520684 100644 --- a/src/proc/mobject/session/plug.cpp +++ b/src/proc/mobject/session/plug.cpp @@ -22,7 +22,7 @@ /** @file plug.cpp - ** TODO plug.cpp + ** @todo result of the very first code generation from UML in 2008. Relevance not clear yet... */ diff --git a/src/proc/mobject/session/plug.hpp b/src/proc/mobject/session/plug.hpp index f415825ed..f7d5f574f 100644 --- a/src/proc/mobject/session/plug.hpp +++ b/src/proc/mobject/session/plug.hpp @@ -22,7 +22,7 @@ /** @file plug.hpp - ** TODO plug.hpp + ** @todo result of the very first code generation from UML in 2008. Relevance not clear yet... */ @@ -45,7 +45,7 @@ namespace session { class Plug : public Wish { protected: - /** the Pipe this MObject wants to be conected to */ + /** the Pipe this MObject wants to be connected to */ asset::Pipe* outPipe; ////////////////////////////////TODO: shared_ptr }; diff --git a/src/proc/mobject/session/query-focus-stack.hpp b/src/proc/mobject/session/query-focus-stack.hpp index 25bc775df..15d9e2625 100644 --- a/src/proc/mobject/session/query-focus-stack.hpp +++ b/src/proc/mobject/session/query-focus-stack.hpp @@ -22,7 +22,9 @@ /** @file query-focus-stack.hpp - ** TODO query-focus-stack.hpp + ** Implementation facility to work with and navigate nested scopes + ** @todo WIP implementation of session core from 2010 + ** @todo as of 2016, this effort is considered stalled but basically valid */ @@ -52,7 +54,7 @@ namespace session { * a boost::intrusive_ptr, which stores the ref-count within * the mentioned ScopePath frames located in the stack. * - * \par automatic cleanup of unused frames + * ## automatic cleanup of unused frames * * The stack is aware of this ref-counting mechanism and will -- * on each access -- automatically clean up any unused frames starting @@ -199,4 +201,4 @@ namespace session { }}} // namespace mobject::session -#endif +#endif /*MOBJECT_SESSION_QUERY_FOCUS_STACK_H*/ diff --git a/src/proc/mobject/session/query-focus.cpp b/src/proc/mobject/session/query-focus.cpp index f51f1e271..9d4baa51b 100644 --- a/src/proc/mobject/session/query-focus.cpp +++ b/src/proc/mobject/session/query-focus.cpp @@ -22,7 +22,8 @@ /** @file query-focus.cpp - ** TODO query-focus.cpp + ** @todo WIP implementation of session core from 2010 + ** @todo as of 2016, this effort is considered stalled but basically valid */ diff --git a/src/proc/mobject/session/query-focus.hpp b/src/proc/mobject/session/query-focus.hpp index dd68b74a9..da1987bd0 100644 --- a/src/proc/mobject/session/query-focus.hpp +++ b/src/proc/mobject/session/query-focus.hpp @@ -22,7 +22,25 @@ /** @file query-focus.hpp - ** TODO query-focus.hpp + ** Representation of the _current scope_ when navigating the session model. + ** Session contents may be discovered by query, and a _current location_ plays a crucial + ** role to fill in any missing details for resolving such a query. Thus, any code in need + ** to query contents or otherwise discover settings currently in effect within a given scope, + ** need to manage the position, where the query resolution is assumed to happen. The query focus + ** acts as an abstracted representation of such a location, and provides means for relative navigation. + ** The implementation involves a hidden service to record a movement trail, which allows to consider + ** the way how a some deeply nested scope was accessed. This information might be of relevance, due + ** to the ability to use _virtual clips_ recursively as part of the edit. Effectively, such means to + ** refer to some edit defined elsewhere in the session, and thus this feature turns the tree of nested + ** scopes into a *DAG* (directed acyclic graph). Such a structure can still be handled as if it was + ** a tree, but we need to take the access path into consideration: placing a given edit as virtual + ** clip into another scope will cause some properties not defined locally to be resolved in a + ** different way, depending on the context in which we encounter this virtual clip. To give an + ** example, the edited media might contain "sound", which needs to be panned and routed differently, + ** depending on the context the clip is placed into. + ** + ** @todo WIP implementation of session core from 2010 + ** @todo as of 2016, this effort is considered stalled but basically valid */ @@ -51,7 +69,7 @@ namespace session { * focus path locations. The intention is for this current location * to follow the ongoing query/discovery operations mostly automatically. * - * \par usage + * # usage * * A QueryFocus (frontend handle) can be default constructed, in which * case it will automatically connect to what is currently the focus diff --git a/src/proc/mobject/session/query/fake-configrules.cpp b/src/proc/mobject/session/query/fake-configrules.cpp index 492faeeb3..30c81ab7a 100644 --- a/src/proc/mobject/session/query/fake-configrules.cpp +++ b/src/proc/mobject/session/query/fake-configrules.cpp @@ -22,7 +22,17 @@ /** @file fake-configrules.cpp - ** TODO fake-configrules.cpp + ** Implementation of a fake query resolution service based on preconfigured answers. + ** Since we're not able to build or even integrate a real resolution engine for the time being, + ** we use a table of preconfigured answers, which allows us to handle the standard cases and + ** some additional unit test cases. + ** + ** Obviously this is a dirty hack, and the implementation is a pile of spaghetti code, + ** hastily bashed together to keep things going. Typically this fake code collaborates with + ** backdoor functions placed into otherwise not yet implemented facilities, to get past the + ** roadblock. For example, StructFactory::made4fake() + ** + ** @deprecated integrate a real resolution engine! /////////////////////////////////////////////////////////TICKET #710 */ @@ -42,7 +52,7 @@ using lib::Literal; using util::isnil; -//////////////////////////////////////////////////////////////////TICKET #710 : to be removed entirely in Alpha +/////////////////////////////////////////////////////////////////////////////////////////////////////////////TICKET #710 : to be removed entirely in Alpha namespace proc { namespace mobject { diff --git a/src/proc/mobject/session/relativelocation.cpp b/src/proc/mobject/session/relativelocation.cpp index a5d258e2c..bcb2002d1 100644 --- a/src/proc/mobject/session/relativelocation.cpp +++ b/src/proc/mobject/session/relativelocation.cpp @@ -22,7 +22,9 @@ /** @file relativelocation.cpp - ** TODO relativelocation.cpp + ** LocatingPin (constraint) to attach media objects relative to each other + ** @todo stalled effort towards a session implementation from 2008 + ** @todo 2016 likely to stay, but expect some extensive rework */ diff --git a/src/proc/mobject/session/relativelocation.hpp b/src/proc/mobject/session/relativelocation.hpp index 52b466893..d106b0751 100644 --- a/src/proc/mobject/session/relativelocation.hpp +++ b/src/proc/mobject/session/relativelocation.hpp @@ -22,7 +22,8 @@ /** @file relativelocation.hpp - ** TODO relativelocation.hpp + ** @todo stalled effort towards a session implementation from 2008 + ** @todo 2016 likely to stay, but expect some extensive rework */ diff --git a/src/proc/mobject/session/root.cpp b/src/proc/mobject/session/root.cpp index 612328ca9..dace7ce9a 100644 --- a/src/proc/mobject/session/root.cpp +++ b/src/proc/mobject/session/root.cpp @@ -22,7 +22,8 @@ /** @file root.cpp - ** TODO root.cpp + ** @todo WIP implementation of session core from 2010 + ** @todo as of 2016, this effort is considered stalled but basically valid */ diff --git a/src/proc/mobject/session/root.hpp b/src/proc/mobject/session/root.hpp index b2c42d0e4..ac56e9433 100644 --- a/src/proc/mobject/session/root.hpp +++ b/src/proc/mobject/session/root.hpp @@ -22,7 +22,15 @@ /** @file root.hpp - ** TODO root.hpp + ** MObject within the session to represent "the session itself". + ** The root object is used as anchor point when it comes to building, accessing + ** or displaying the whole session. Moreover, the placement used to attach the + ** Root MObejct into the session effectively represents the "global scope" -- any + ** constraint attached to this placement possibly effects any other object placed + ** anywhere within this global scope... + ** + ** @todo WIP implementation of session core from 2010 + ** @todo as of 2016, this effort is considered stalled but basically valid */ diff --git a/src/proc/mobject/session/scope-locator.hpp b/src/proc/mobject/session/scope-locator.hpp index 44264dff8..0d790d1f7 100644 --- a/src/proc/mobject/session/scope-locator.hpp +++ b/src/proc/mobject/session/scope-locator.hpp @@ -22,7 +22,9 @@ /** @file scope-locator.hpp - ** TODO scope-locator.hpp + ** Service to build the notion of a _current location_ within the Sesison model + ** @todo WIP implementation of session core from 2010 + ** @todo as of 2016, this effort is considered stalled but basically valid */ @@ -52,7 +54,7 @@ namespace session { /** * Singleton service establishing a link to relate * any compound of nested placement scopes to the current session - * and the \em current focus for querying and exploring this structure. + * and the _current focus_ for querying and exploring this structure. * While it is OK to use this service directly, clients usually would * prefer to use QueryFocus as a frontend. * diff --git a/src/proc/mobject/session/scope-path.cpp b/src/proc/mobject/session/scope-path.cpp index 6b17996b5..00c1f0266 100644 --- a/src/proc/mobject/session/scope-path.cpp +++ b/src/proc/mobject/session/scope-path.cpp @@ -22,7 +22,8 @@ /** @file scope-path.cpp - ** TODO scope-path.cpp + ** @todo WIP implementation of session core from 2010 + ** @todo as of 2016, this effort is considered stalled but basically valid */ diff --git a/src/proc/mobject/session/scope.hpp b/src/proc/mobject/session/scope.hpp index 10966f840..f25eea594 100644 --- a/src/proc/mobject/session/scope.hpp +++ b/src/proc/mobject/session/scope.hpp @@ -22,7 +22,8 @@ /** @file scope.hpp - ** TODO scope.hpp + ** @todo WIP implementation of session core from 2010 + ** @todo as of 2016, this effort is considered stalled but basically valid */ diff --git a/src/proc/mobject/session/segment.cpp b/src/proc/mobject/session/segment.cpp index 2bdb5071e..9f601809a 100644 --- a/src/proc/mobject/session/segment.cpp +++ b/src/proc/mobject/session/segment.cpp @@ -22,7 +22,8 @@ /** @file segment.cpp - ** TODO segment.cpp + ** @todo stalled effort towards a session implementation from 2008 + ** @todo 2016 likely to stay, but expect some extensive rework */ #include "proc/mobject/session/segment.hpp" diff --git a/src/proc/mobject/session/segment.hpp b/src/proc/mobject/session/segment.hpp index ab094d934..7eba07412 100644 --- a/src/proc/mobject/session/segment.hpp +++ b/src/proc/mobject/session/segment.hpp @@ -22,7 +22,9 @@ /** @file segment.hpp - ** TODO segment.hpp + ** Building block of the backbone of the low-level (render node) model + ** @todo stalled effort towards a session implementation from 2008 + ** @todo 2016 likely to stay, but expect some extensive rework */ diff --git a/src/proc/mobject/session/segmentation.cpp b/src/proc/mobject/session/segmentation.cpp index e13d75bef..0a8d9c721 100644 --- a/src/proc/mobject/session/segmentation.cpp +++ b/src/proc/mobject/session/segmentation.cpp @@ -22,7 +22,8 @@ /** @file segmentation.cpp - ** TODO segmentation.cpp + ** @todo stalled effort towards a session implementation from 2008 + ** @todo 2016 likely to stay, but expect some extensive rework */ #include "proc/mobject/session/segmentation.hpp" diff --git a/src/proc/mobject/session/segmentation.hpp b/src/proc/mobject/session/segmentation.hpp index f69baf58d..047ced48b 100644 --- a/src/proc/mobject/session/segmentation.hpp +++ b/src/proc/mobject/session/segmentation.hpp @@ -22,7 +22,14 @@ /** @file segmentation.hpp - ** TODO segmentation.hpp + ** A segment of the effective timeline, part of the low-level model backbone. + ** Within the Fixture, a Segment of the timeline is used as attachment point for all the + ** render nodes relevant for rendering this segment. Thus, the Segmentation defines the + ** index and access datastructure to get at any point of the render node network. + ** Moreover, the segments are used as foundation for render node memory management + ** + ** @todo stalled effort towards a session implementation from 2008 + ** @todo 2016 likely to stay, but expect some extensive rework */ diff --git a/src/proc/mobject/session/sess-manager-impl.cpp b/src/proc/mobject/session/sess-manager-impl.cpp index 4bdd00317..452fe23ae 100644 --- a/src/proc/mobject/session/sess-manager-impl.cpp +++ b/src/proc/mobject/session/sess-manager-impl.cpp @@ -29,7 +29,7 @@ ** access via his overloaded operator->() . Because there is no operator*(), ** no one can get at the address of the current session object. (correct?) ** - ** TODO: this is an implementation draft, awaiting integration with several other facilities //////////////////TICKET #704 + ** @todo as of 2016 this is an implementation draft, awaiting integration with several other facilities //////////////////TICKET #704 ** ** @see session-impl.hpp ** @see mobject::Session#current diff --git a/src/proc/mobject/session/sess-manager-impl.hpp b/src/proc/mobject/session/sess-manager-impl.hpp index 9dc6c5e58..384b9b506 100644 --- a/src/proc/mobject/session/sess-manager-impl.hpp +++ b/src/proc/mobject/session/sess-manager-impl.hpp @@ -22,7 +22,18 @@ /** @file sess-manager-impl.hpp - ** TODO sess-manager-impl.hpp + ** Implementation facility for session management. + ** Users are assumed to access the session itself through a smart-ptr, which happens + ** to be the SessManager. Thus, accessing this front-end directly allows to invoke the + ** typical lifecycle and management operations (open, close, save, load). Since the + ** Session plays such a central role, we obviously want to expose just an interface + ** to client code, both regarding the Session itself, and the session manager. + ** + ** The SessManagerImpl involves the LifecylceAdvisor, which holds all the logic to + ** manage start-up and shutdown of the session, including starting of the core services + ** and opening of the external facade interfaces. + ** + ** @todo as of 2016, this effort is considered stalled but basically valid */ diff --git a/src/proc/mobject/session/session-impl.cpp b/src/proc/mobject/session/session-impl.cpp index 34f90b345..40c00d68b 100644 --- a/src/proc/mobject/session/session-impl.cpp +++ b/src/proc/mobject/session/session-impl.cpp @@ -22,7 +22,9 @@ /** @file session-impl.cpp - ** TODO session-impl.cpp + ** Implementation of the global session datastructure + ** @todo WIP implementation of session core from 2010 + ** @todo as of 2016, this effort is considered stalled but basically valid */ diff --git a/src/proc/mobject/session/session-services.cpp b/src/proc/mobject/session/session-services.cpp index 2994660d6..167daefbb 100644 --- a/src/proc/mobject/session/session-services.cpp +++ b/src/proc/mobject/session/session-services.cpp @@ -22,7 +22,22 @@ /** @file session-services.cpp - ** TODO session-services.cpp + ** Implementation of some top-level internal services of the session. + ** The Session is _the_ central interface to access the model and thus the + ** edit being worked on. Behind the scenes, it needs to operate several technically + ** quite involved services, which we prefer to hide away as implementation details. + ** Typically, each of these services defines a dedicated interface, and is implemented + ** by delegating to a set of more specialised facilities. + ** + ** The following services are integrated here + ** - service to access a Placement by (hash) ID + ** - service to attach or remove session content, while maintaining all indices + ** - service to query and explore session contents + ** - service to inject mock content for unit testing + ** - service to manage and discover default settings by resolution query + ** + ** @todo WIP implementation of session core from 2010 + ** @todo as of 2016, this effort is considered stalled but basically valid */ diff --git a/src/proc/mobject/session/specific-contents-query.hpp b/src/proc/mobject/session/specific-contents-query.hpp index fea11cccc..08303fae3 100644 --- a/src/proc/mobject/session/specific-contents-query.hpp +++ b/src/proc/mobject/session/specific-contents-query.hpp @@ -22,7 +22,12 @@ /** @file specific-contents-query.hpp - ** TODO specific-contents-query.hpp + ** Implementation facility to query and retrieve session context with filtering conditions. + ** Client code is assumed to use the QueryResolver front-end and the SessionServiceExploreScope + ** as access point. + ** + ** @todo WIP implementation of session core from 2010 + ** @todo as of 2016, this effort is considered stalled but basically valid */ diff --git a/src/proc/mobject/session/wish.cpp b/src/proc/mobject/session/wish.cpp index 58f688e51..dd538ca65 100644 --- a/src/proc/mobject/session/wish.cpp +++ b/src/proc/mobject/session/wish.cpp @@ -22,7 +22,7 @@ /** @file wish.cpp - ** TODO wish.cpp + ** @todo result of the very first code generation from UML in 2008. Relevance not clear yet... */ diff --git a/src/proc/mobject/session/wish.hpp b/src/proc/mobject/session/wish.hpp index aaffbc3a5..3b3c27392 100644 --- a/src/proc/mobject/session/wish.hpp +++ b/src/proc/mobject/session/wish.hpp @@ -22,7 +22,8 @@ /** @file wish.hpp - ** TODO wish.hpp + ** @todo result of the very first code generation from UML in 2008. Relevance not clear yet... + ** @deprecated WTF? */ From fb15c258ea484c73a204a990fd307f0ed4b34f6c Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Wed, 9 Nov 2016 23:17:02 +0100 Subject: [PATCH 21/26] Doxygen: fill in missing file level headlines for Proc-Layer (top-level) --- src/proc/mobject/builderfacade.cpp | 25 ++++++++------ src/proc/mobject/builderfacade.hpp | 28 ++++++++------- src/proc/mobject/explicitplacement.hpp | 18 +++++++--- src/proc/mobject/interpolator.cpp | 38 --------------------- src/proc/mobject/interpolator.hpp | 12 ++++--- src/proc/mobject/mobject.cpp | 2 +- src/proc/mobject/mobject.hpp | 18 +++++++--- src/proc/mobject/output-designation.hpp | 17 ++++++++-- src/proc/mobject/parameter.cpp | 4 ++- src/proc/mobject/parameter.hpp | 10 +++--- src/proc/mobject/paramprovider.cpp | 4 ++- src/proc/mobject/paramprovider.hpp | 10 +++--- src/proc/mobject/placement.cpp | 2 +- src/proc/mobject/placement.hpp | 45 +++++++++++++------------ 14 files changed, 122 insertions(+), 111 deletions(-) delete mode 100644 src/proc/mobject/interpolator.cpp diff --git a/src/proc/mobject/builderfacade.cpp b/src/proc/mobject/builderfacade.cpp index 5543aa885..3d670f1da 100644 --- a/src/proc/mobject/builderfacade.cpp +++ b/src/proc/mobject/builderfacade.cpp @@ -22,30 +22,33 @@ /** @file builderfacade.cpp - ** TODO builderfacade.cpp + ** Implementation of top-level access to builder functionality */ #include "proc/mobject/builder/common.hpp" #include "proc/mobject/builderfacade.hpp" +#include "proc/mobject/session/fixture.hpp" namespace proc { namespace mobject { - - /** - * Main Operation of the Builder: - * create a render engine for a given part of the timeline - */ - engine::RenderEngine & - BuilderFacade::buildEngine () - { - //////////////////////TODO - } + using session::Fixture; LUMIERA_ERROR_DEFINE (BUILDER_LIFECYCLE, "Builder activated while in non operational state"); + /** + * Main Operation of the Builder: + * rebuild the low-level model based on the current contents of the Session. + */ + Fixture& + BuilderFacade:: rebuildFixture () + { + UNIMPLEMENTED ("build the builder..."); + } + + }} // namespace mobject diff --git a/src/proc/mobject/builderfacade.hpp b/src/proc/mobject/builderfacade.hpp index 22963c6ae..2148e651b 100644 --- a/src/proc/mobject/builderfacade.hpp +++ b/src/proc/mobject/builderfacade.hpp @@ -22,19 +22,28 @@ /** @file builderfacade.hpp - ** TODO builderfacade.hpp + ** Proc-Layer Facade: access to the Builder. + ** The Builder walks the Session model to compile a corresponding render node network. + ** + ** @todo as of 2016 the builder, as the most crucial component within the architecture, + ** still remains to be addressed. While we'd hoped to get ahead faster, it is considered + ** a good idea not to decide upon the implementation based on assumptions. + ** We will start building the builder "when it is ready" */ -#ifndef MOBJECT_BUILDERFACADE_H -#define MOBJECT_BUILDERFACADE_H +#ifndef PROC_MOBJECT_BUILDERFACADE_H +#define PROC_MOBJECT_BUILDERFACADE_H +#include "lib/error.hpp" #include "proc/mobject/builder/common.hpp" -#include "proc/engine/renderengine.hpp" namespace proc { namespace mobject { + namespace session { + class Fixture; + } LUMIERA_ERROR_DECLARE (BUILDER_LIFECYCLE); ///< Builder activated while in non operational state @@ -47,17 +56,10 @@ namespace mobject { class BuilderFacade { public: - /** - * Main Operation of the Builder: - * create a render engine for a given part of the timeline - * @deprecated thats a placeholder! the real invocation is now - * in the course of being worked out ////////////TODO 12/2010 - */ - engine::RenderEngine & buildEngine () ; - // TODO: allocation, GC?????? + session::Fixture & rebuildFixture (); }; }} // namespace proc::mobject -#endif +#endif /*PROC_MOBJECT_BUILDERFACADE_H*/ diff --git a/src/proc/mobject/explicitplacement.hpp b/src/proc/mobject/explicitplacement.hpp index 4628d5889..655a4c6a1 100644 --- a/src/proc/mobject/explicitplacement.hpp +++ b/src/proc/mobject/explicitplacement.hpp @@ -22,12 +22,22 @@ /** @file explicitplacement.hpp - ** TODO explicitplacement.hpp + ** Core abstraction: completely resolved placement of an MObject + ** Within the session model, all media objects are attached with the help + ** of mobject::Placement elements. These are the "glue" to stitch the model + ** together. However, placements are typically only defined in parts, and what + ** is left out in the definition is assumed to be _"obvious from the context"._ + ** + ** The core operation within Proc-Layer is the Builder run, which walks the Session model + ** to resolve and fill in all the contextual information. The result is a completely resolved + ** Placement for each actually visible and relevant entity. Such is represented as ExplicitPlacement. + ** These are arranged into the backbone structure, the Fixture, and the actual render node network + ** necessary to _render_ those contents is attached below. */ -#ifndef MOBJECT_EXPLICITPLACEMENT_H -#define MOBJECT_EXPLICITPLACEMENT_H +#ifndef PROC_MOBJECT_EXPLICITPLACEMENT_H +#define PROC_MOBJECT_EXPLICITPLACEMENT_H #include "proc/mobject/placement.hpp" @@ -90,4 +100,4 @@ namespace mobject { }} // namespace proc::mobject -#endif +#endif /*PROC_MOBJECT_EXPLICITPLACEMENT_H*/ diff --git a/src/proc/mobject/interpolator.cpp b/src/proc/mobject/interpolator.cpp deleted file mode 100644 index e0d2d4be3..000000000 --- a/src/proc/mobject/interpolator.cpp +++ /dev/null @@ -1,38 +0,0 @@ -/* - Interpolator - denotes a facility to get (continuously interpolated) parameter values - - Copyright (C) Lumiera.org - 2008, Hermann Vosseler - - 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 interpolator.cpp - ** TODO interpolator.cpp - */ - - -#include "proc/mobject/interpolator.hpp" - -namespace proc { -namespace mobject { - - /** */ - - - -}} // namespace proc::mobject diff --git a/src/proc/mobject/interpolator.hpp b/src/proc/mobject/interpolator.hpp index 14c001713..9d59ed8b4 100644 --- a/src/proc/mobject/interpolator.hpp +++ b/src/proc/mobject/interpolator.hpp @@ -22,12 +22,14 @@ /** @file interpolator.hpp - ** TODO interpolator.hpp + ** Core abstraction: automation parameter interpolator + ** Each interpolator implementation has the ability to resolve intermediary + ** values and to provide a parameter value for _every arbitrary point in time._ */ -#ifndef MOBJECT_INTERPOLATOR_H -#define MOBJECT_INTERPOLATOR_H +#ifndef PROC_MOBJECT_INTERPOLATOR_H +#define PROC_MOBJECT_INTERPOLATOR_H @@ -36,7 +38,7 @@ namespace mobject { /** - * Provides the implementation for getting the acutal value + * Provides the implementation for getting the actual value * of a time varying or automated effect/plugin parameter */ template @@ -48,4 +50,4 @@ namespace mobject { }} // namespace proc::mobject -#endif +#endif /*PROC_MOBJECT_INTERPOLATOR_H*/ diff --git a/src/proc/mobject/mobject.cpp b/src/proc/mobject/mobject.cpp index b7b18905d..e4f1047d7 100644 --- a/src/proc/mobject/mobject.cpp +++ b/src/proc/mobject/mobject.cpp @@ -22,7 +22,7 @@ /** @file mobject.cpp - ** TODO mobject.cpp + ** Top level implementation functions globally relevant to the session model */ diff --git a/src/proc/mobject/mobject.hpp b/src/proc/mobject/mobject.hpp index 6c68c46c4..214ec19ff 100644 --- a/src/proc/mobject/mobject.hpp +++ b/src/proc/mobject/mobject.hpp @@ -22,12 +22,22 @@ /** @file mobject.hpp - ** TODO mobject.hpp + ** Core abstraction of the Session model: a media object. + ** The contents of the edit and thus of the session are modelled as a collection + ** of MObject entities, each attached by a Placement. Together these form what can + ** be conceived as an _instance_ of the object. The Placement constitutes the relative + ** and contextual information, while the MObject provides the identity and the link + ** to actual media content or plug-in implementations. + ** + ** @todo as of 2016, this core part of the model still needs to be actually implemented. + ** Most of the code in this hierarchy is preliminary or placeholder code, since we + ** prefer to build the system from ground up, not top-down. It is very likely, that + ** MObject will be just a data tuple in the end. */ -#ifndef MOBJECT_MOBJECT_H -#define MOBJECT_MOBJECT_H +#ifndef PROC_MOBJECT_MOBJECT_H +#define PROC_MOBJECT_MOBJECT_H #include "proc/common.hpp" #include "proc/mobject/builder/buildertool.hpp" @@ -113,4 +123,4 @@ namespace mobject { }} // namespace proc::mobject -#endif +#endif /*PROC_MOBJECT_MOBJECT_H*/ diff --git a/src/proc/mobject/output-designation.hpp b/src/proc/mobject/output-designation.hpp index 3823c1c13..c9469bdf8 100644 --- a/src/proc/mobject/output-designation.hpp +++ b/src/proc/mobject/output-designation.hpp @@ -22,7 +22,18 @@ /** @file output-designation.hpp - ** TODO output-designation.hpp + ** Core abstraction: symbolic representation of some output target. + ** An OutputDesignation represents something you might want to connect to + ** or towards which you'd like to direct output. It might be _absolute,_ in + ** which case it represents an actual output device attached to the system, + ** or it might be relative, as a placeholder for further wiring and output routing. + ** An example for the latter would be the "master bus". + ** + ** The concept of an OutputDesignation plays a crucial role to allow flexible connection + ** and rearrangement of media content. It allows to build partial structures, which can + ** be connected automatically to a suitable output when placed into the appropriate context. + ** In the end, the Builder will resolve all output designations, finally leading to a fixed + ** set of exit nodes, which can be pulled to deliver content. */ @@ -54,7 +65,7 @@ namespace mobject { * OutputDesignation is always an internal and relative specification * and boils down to referring an asset::Pipe by ID. In order to become * actually effective, some object within the model additionally - * needs to \em claim this pipe-ID, meaning that this object + * needs to _claim_ this pipe-ID, meaning that this object * states to root and represent this pipe. When the builder * encounters a pair of (OutputDesignation, OutputClaim), * an actual stream connection will be wired in the @@ -123,4 +134,4 @@ namespace mobject { }} // namespace proc::mobject -#endif +#endif /*PROC_MOBJECT_OUTPUT_DESIGNATION_H*/ diff --git a/src/proc/mobject/parameter.cpp b/src/proc/mobject/parameter.cpp index d13179ec3..25cd61034 100644 --- a/src/proc/mobject/parameter.cpp +++ b/src/proc/mobject/parameter.cpp @@ -22,7 +22,9 @@ /** @file parameter.cpp - ** TODO parameter.cpp + ** Implementation functions of the Parameter abstraction. + ** + ** @todo as of 2016, we still need to work out our parameter/automation concept. */ diff --git a/src/proc/mobject/parameter.hpp b/src/proc/mobject/parameter.hpp index 3e22d138a..0782557f0 100644 --- a/src/proc/mobject/parameter.hpp +++ b/src/proc/mobject/parameter.hpp @@ -22,12 +22,14 @@ /** @file parameter.hpp - ** TODO parameter.hpp + ** Core abstraction: parameter to be controlled and possibly automated. + ** + ** @todo as of 2016, we still need to work out our parameter/automation concept. */ -#ifndef PROC_MOBJECT_PARAMETER_H -#define PROC_MOBJECT_PARAMETER_H +#ifndef PROC_PROC_MOBJECT_PARAMETER_H +#define PROC_PROC_MOBJECT_PARAMETER_H @@ -57,4 +59,4 @@ namespace mobject { }} // namespace proc::mobject -#endif +#endif /*PROC_PROC_MOBJECT_PARAMETER_H*/ diff --git a/src/proc/mobject/paramprovider.cpp b/src/proc/mobject/paramprovider.cpp index 9571b8e28..617ac4618 100644 --- a/src/proc/mobject/paramprovider.cpp +++ b/src/proc/mobject/paramprovider.cpp @@ -22,7 +22,9 @@ /** @file paramprovider.cpp - ** TODO paramprovider.cpp + ** Implementation functions of the Parameter abstraction. + ** + ** @todo as of 2016, we still need to work out our parameter/automation concept. */ diff --git a/src/proc/mobject/paramprovider.hpp b/src/proc/mobject/paramprovider.hpp index 881542ea5..24bdb8ec7 100644 --- a/src/proc/mobject/paramprovider.hpp +++ b/src/proc/mobject/paramprovider.hpp @@ -22,12 +22,14 @@ /** @file paramprovider.hpp - ** TODO paramprovider.hpp + ** Core abstraction: an entity to expose a single parameter + ** + ** @todo as of 2016, we still need to work out our parameter/automation concept. */ -#ifndef MOBJECT_PARAMPROVIDER_H -#define MOBJECT_PARAMPROVIDER_H +#ifndef PROC_MOBJECT_PARAMPROVIDER_H +#define PROC_MOBJECT_PARAMPROVIDER_H @@ -57,4 +59,4 @@ namespace mobject { }} // namespace proc::mobject -#endif +#endif /*PROC_MOBJECT_PARAMPROVIDER_H*/ diff --git a/src/proc/mobject/placement.cpp b/src/proc/mobject/placement.cpp index 70815632d..200811d36 100644 --- a/src/proc/mobject/placement.cpp +++ b/src/proc/mobject/placement.cpp @@ -22,7 +22,7 @@ /** @file placement.cpp - ** TODO placement.cpp + ** Implementation functions belonging to the Placement entity */ diff --git a/src/proc/mobject/placement.hpp b/src/proc/mobject/placement.hpp index 25812e85c..1f77ad14b 100644 --- a/src/proc/mobject/placement.hpp +++ b/src/proc/mobject/placement.hpp @@ -21,19 +21,22 @@ */ -/** @file placement.hpp - ** 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 Session and Fixture and thus - ** are small handle like objects. Many editing tasks include locating some Placement - ** within the Session or directly take a ref to a Placement. +/** @file placement.hpp + ** Core abstraction: placement of a media object into session context. + ** 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" stored within the the Session and Fixture + ** data structure and thus are small handle like objects, which can be processed efficiently. + ** Many editing tasks include locating some Placement within the Session or directly take + ** a reference to a Placement. A Placement represents a _specific way to attach content._ + ** They may refer to contextual information and relate themselves to other placements. ** - ** Placements are refcounting smart pointers: By acting on the Placement object, - ** we can change parameters of the way the media object is placed (e.g. adjust an offset), - ** while by dereferencing the Placement object, we access the "real" media object. - ** Usually, any MObject is created by a factory and immediately wrapped into a Placement, + ** On the implementation level, placements are *refcounting smart pointers*: By acting + ** on the Placement object, we can change parameters of the way the media object is placed + ** (e.g. adjust an offset), while by dereferencing the Placement object, we access the media + ** object itself. Usually, any MObject is created by a factory and immediately wrapped into a Placement, ** which takes ownership of the MObject. - ** + ** ** Besides being a handle, Placements define the logical position where some MObject is ** supposed to be located within the Session or Fixture. The way in which this placing happens ** is controlled and parametrised by a collection (chain) of LocatingPin objects. By adding @@ -42,21 +45,21 @@ ** absolute position (time, output). ** ** Together, this yields semantics somewhere in between value semantics and reference semantics. - ** As any smart-ptr, placements are copyable, but each such copy takes on a distinct identity. - ** Moreover, when added to the Session, a placement acts as if it was an \em instance of the object + ** As any smart-ptr, placements are copyable, but each such copy takes on a _distinct identity._ + ** Moreover, when added to the Session, a placement acts as if it was an _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 + ** properties. Thus, such a placement-within-session _is_ a distinguishable entity, because + ** the settings on the contained LocatingPin chain _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). Building on this ID, it is possible to create a - ** smart-ptr like PlacementRef to denote a specific placement found within the Session. + ** placement has an embedded ID (identity). Building on this ID, it is possible in turn to + ** create a smart-ptr like PlacementRef to denote a specific placement found within the Session. ** ** Placements are templated on the type of the actual MObject they refer to, so, sometimes ** e.g. we rather use a Placement to be able to use the more specific methods of the - ** session::Clip interface. But please note the following detail: this type - ** labelling and downcasting is the only difference between these subclasses, - ** besides that, they can be replaced literally by one another (slicing is accepted). - ** + ** session::Clip interface. But _please note the following detail:_ this type labelling + ** and downcasting is the _only_ difference between these subclasses, besides that, + ** they can be replaced literally by one another (slicing acceptable). + ** ** @see ExplicitPlacement ** @see LocatingPin interface for controlling the positioning parameters ** From df46c3f9013f6d1c3334da7df373c669a79757b6 Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Wed, 9 Nov 2016 23:40:46 +0100 Subject: [PATCH 22/26] Doxygen: fill in missing file level headlines for Proc-Layer (Player) --- src/proc/play/dummy-play-connection.cpp | 2 +- src/proc/play/dummy-play-connection.hpp | 28 ++++++++++++------------- src/proc/play/dummy-player-service.cpp | 2 +- src/proc/play/output-director.cpp | 2 +- src/proc/play/output-slot.cpp | 2 +- src/proc/play/output-slot.hpp | 10 ++++----- src/proc/play/play-process.cpp | 2 +- src/proc/play/play-service.cpp | 2 +- src/proc/play/play-service.hpp | 7 ++++--- src/proc/play/render-configurator.cpp | 4 +++- src/proc/play/render-configurator.hpp | 2 +- src/proc/play/sound/jack-output.cpp | 4 +++- src/proc/play/sound/jack-output.hpp | 4 +++- src/proc/play/timings.cpp | 6 +++++- 14 files changed, 44 insertions(+), 33 deletions(-) diff --git a/src/proc/play/dummy-play-connection.cpp b/src/proc/play/dummy-play-connection.cpp index afaad279e..120c0186e 100644 --- a/src/proc/play/dummy-play-connection.cpp +++ b/src/proc/play/dummy-play-connection.cpp @@ -22,7 +22,7 @@ /** @file dummy-play-connection.cpp - ** TODO dummy-play-connection.cpp + ** Implementation of a service for mock render playback to support testing. */ diff --git a/src/proc/play/dummy-play-connection.hpp b/src/proc/play/dummy-play-connection.hpp index 45ca8048a..a48cf3c5f 100644 --- a/src/proc/play/dummy-play-connection.hpp +++ b/src/proc/play/dummy-play-connection.hpp @@ -21,7 +21,7 @@ */ /** @file dummy-play-connection.hpp - ** Dummy and test setup of playback and rendering, \em omitting most of the Lumiera engine. + ** Dummy and test setup of playback and rendering, _omitting most_ of the Lumiera engine. ** Building this dummy configuration was driven by the need to test and verify the design ** in the course of building the foundations of the render engine. The design of Lumiera's ** engine is elaborate, and thus -- for a long time -- we have to live with a not-yet @@ -32,7 +32,7 @@ ** these placeholders are connected, allowing to produce specific test situations and then ** verify the results after the test run. ** - ** \par Use cases + ** # Use cases ** This dummy setup can be used in various circumstances ** - for unit tests we want to produce artificial test media frames: each TestFrame is ** produced with a reproducible pseudo-random sequence and can be verified to the last bit. @@ -44,16 +44,16 @@ ** to verify a more complicated wiring setup. Thus, the DummyPlayConnection is there to stay! ** ** Because these are somewhat similar usage scenarios, where this and that part is to be exchanged - ** for some, we prefer a policy based design here: The DummyPlayConnection is templated - ** to use a \em strategy, filling in the variable parts. + ** for some, we prefer a _policy based design_ here: The DummyPlayConnection is templated + ** to use _a strategy,_ filling in the variable parts. ** - ** \par provided test services + ** # provided test services ** By using different strategy template parameters, we create different flavours of the dummy; ** each one counting as a separate setup (not related to each other, that is). The actual instance ** then can just be default created; it should be placed into an scope enduring the whole usage ** cycle. Repeated re-initialisation or re-loading is outside the intended usage scope here. ** - ** The core interface allows to retrieve dummy implementations of + ** The *core interface* allows to retrieve dummy implementations of ** - a session model exposing exit node(s) ** - generator object(s) to live within this session model ** - corresponding generator nodes to serve as implementation of the former @@ -61,9 +61,9 @@ ** - OutputSlot implementations to serve as pseudo- or demo output facilities ** - an OutputManager exposing those output facilities. ** - ** The test support interface provides a test driver for performing a controlled + ** The *test support interface* provides a test driver for performing a controlled ** playback or rendering for some time. Thus, a test routine may lock into a blocking wait, - ** to investigate results after the planned test sequence was performed. + ** to investigate results after the planned test sequence was performed. ** ** @see lumiera::DummyPlayer ** @see gui::PlaybackController usage example @@ -129,10 +129,10 @@ namespace play { // using lib::ScopedCollection; // using lib::Literal; using lib::eachEntry; - + typedef asset::ID PID; typedef asset::ID TID; - + // typedef ModelPortRegistry::ModelPortDescriptor const& MPDescriptor; @@ -153,7 +153,7 @@ namespace play { const string namePortB("bus-B"); /** - * helper for dummy render engine: + * helper for dummy render engine: * Simulate the result of a build process, * without actually running the builder. * Produces some mock pipes, model ports etc. @@ -208,7 +208,7 @@ namespace play { } }; } - + /****************************************************************//** * Framework for dummy playback and rendering. @@ -216,7 +216,7 @@ namespace play { * allowing to start a data producing process while leaving out * various parts of the real engine implementation. The specific * mode of operation, suitable for various test scenarios, may be - * fine tuned by the strategy object defined as template parameter. + * fine tuned by the strategy object defined as template parameter. */ template class DummyPlayConnection @@ -274,4 +274,4 @@ namespace play { }} // namespace proc::play -#endif +#endif /*PROC_PLAY_DUMMY_PLAY_CONNECTION_H*/ diff --git a/src/proc/play/dummy-player-service.cpp b/src/proc/play/dummy-player-service.cpp index 04f227498..2e3e829d2 100644 --- a/src/proc/play/dummy-player-service.cpp +++ b/src/proc/play/dummy-player-service.cpp @@ -22,7 +22,7 @@ /** @file dummy-player-service.cpp - ** TODO dummy-player-service.cpp + ** Implementation of a service for mock render output to support testing. */ diff --git a/src/proc/play/output-director.cpp b/src/proc/play/output-director.cpp index bd6f85dfd..171a349dd 100644 --- a/src/proc/play/output-director.cpp +++ b/src/proc/play/output-director.cpp @@ -22,7 +22,7 @@ /** @file output-director.cpp - ** TODO output-director.cpp + ** Implementation of global output connection management */ diff --git a/src/proc/play/output-slot.cpp b/src/proc/play/output-slot.cpp index 723aeb8a6..15e50f999 100644 --- a/src/proc/play/output-slot.cpp +++ b/src/proc/play/output-slot.cpp @@ -22,7 +22,7 @@ /** @file output-slot.cpp - ** TODO output-slot.cpp + ** Generic implementation functionality common to all output connections. */ diff --git a/src/proc/play/output-slot.hpp b/src/proc/play/output-slot.hpp index cc93f08ef..3d99c1589 100644 --- a/src/proc/play/output-slot.hpp +++ b/src/proc/play/output-slot.hpp @@ -32,7 +32,7 @@ ** external output, or a group of such outputs (e.g. left and right sound card output channels), ** or an output file or similar capability accepting media content. Initially, an output slot ** needs to be provided, configured and registered, using an implementation suitable for the - ** kind of media data to be output (sound, video) and also suitable for the special circumstances + ** kind of media data to be sent (sound, video) and also suitable for the special circumstances ** of the output capability (render a file, display video in a GUI widget, send video to some ** full screen display, establish a Jack port, just use some kind of "sound out"). An output ** slot is always limited to a single kind of media, and to a single connection unit, but @@ -43,16 +43,16 @@ ** there may be only a single client using a given output slot this way. To stress this point: ** output slots don't provide any kind of inherent mixing capability; any adaptation, mixing, ** overlaying and sharing needs to be done within the nodes network producing the output data - ** to be fed into the slot. (in special cases, some external output capabilities — e.g. the - ** Jack audio connection system — may still provide additional mixing capabilities, + ** to be fed into the slot. (in special cases, some external output capabilities -- e.g. the + ** Jack audio connection system -- may still provide additional mixing capabilities, ** but that's beyond the scope of the Lumiera application) ** ** Once allocated, the output slot returns a set of concrete sink handles (one for each ** physical channel expecting data). The calculating process feeds its results into those handles. ** Size and other characteristics of the data frames are assumed to be suitable, which typically ** won't be verified at that level anymore. Besides that, the allocation of an output slot reveals - ** detailed timing expectations. The client is required to comply to these timings when \em emitting - ** data — he's even required to provide a current time specification, alongside with the data. + ** detailed timing expectations. The client is required to comply to these timings when _emitting_ + ** data -- he's even required to provide a current time specification, alongside with the data. ** Based on this information, the output slot has the ability to handle timing failures gracefully; ** the concrete output slot implementation is expected to provide some kind of de-click or ** de-flicker facility, which kicks in automatically when a timing failure is detected. diff --git a/src/proc/play/play-process.cpp b/src/proc/play/play-process.cpp index 9d32fecf8..e069b38d6 100644 --- a/src/proc/play/play-process.cpp +++ b/src/proc/play/play-process.cpp @@ -22,7 +22,7 @@ /** @file play-process.cpp - ** TODO play-process.cpp + ** Implementation to organise an ongoing playback/rendering process */ diff --git a/src/proc/play/play-service.cpp b/src/proc/play/play-service.cpp index be686e971..af072bc4f 100644 --- a/src/proc/play/play-service.cpp +++ b/src/proc/play/play-service.cpp @@ -22,7 +22,7 @@ /** @file play-service.cpp - ** TODO play-service.cpp + ** Implementation of core parts of the Player subsystem */ diff --git a/src/proc/play/play-service.hpp b/src/proc/play/play-service.hpp index 491bee8fb..dec178e91 100644 --- a/src/proc/play/play-service.hpp +++ b/src/proc/play/play-service.hpp @@ -30,12 +30,12 @@ ** of the High-Level-Model). These model ports are the (side effect) result of a ** build process performed on the High-Level-Model, causing all nominal output ** designations within the model to be resolved as far as possible. Additionally, - ** for \em playback, the global level of the model (the global pipes of a timeline) + ** for _playback,_ the global level of the model (the global pipes of a timeline) ** need to be connected to a viewer component. This results in a further resolution ** step, mapping the output designations to the concrete output possibilities of ** the running Lumiera instance. This mapping information is kept embedded within ** an OutputManager instance, passed as parameter when invoking the player service. - ** Alternatively, for \em rendering, a similar kind of output mapping information + ** Alternatively, for _rendering,_ a similar kind of output mapping information ** needs to be provided, again embedded within an OutputManager instance, this ** time leading to an output file to be rendered. ** @@ -46,7 +46,8 @@ ** the scenes the corresponding PlayProcess gets terminated and prepared for cleanup. ** ** @see engine::EngineService - ** @todo WIP-WIP-WIP as of Nov.2011 + ** @todo started as draft in 11/2011 + ** @todo as of 2016 development in this area is stalled, but the design done thus far valid ** */ diff --git a/src/proc/play/render-configurator.cpp b/src/proc/play/render-configurator.cpp index 603bfb113..ecbadc4e6 100644 --- a/src/proc/play/render-configurator.cpp +++ b/src/proc/play/render-configurator.cpp @@ -22,7 +22,9 @@ /** @file render-configurator.cpp - ** TODO render-configurator.cpp + ** Implementation functionality to bridge between engine::PlayService and engine::EngineService. + ** The former allows to start playback (or rendering) as a high-level activity, while the latter + ** can manage and perform [calculation streams](\ref CalcStream) */ diff --git a/src/proc/play/render-configurator.hpp b/src/proc/play/render-configurator.hpp index c3c88910e..0214aff13 100644 --- a/src/proc/play/render-configurator.hpp +++ b/src/proc/play/render-configurator.hpp @@ -21,7 +21,7 @@ */ /** @file render-configurator.hpp - ** Strategy holding all the detail knowledge necessary to establish + ** Strategy to hold all the detail knowledge necessary to establish ** a running render CalculationStream. ** ** @see engine::EngineService diff --git a/src/proc/play/sound/jack-output.cpp b/src/proc/play/sound/jack-output.cpp index de7f7831a..85f857387 100644 --- a/src/proc/play/sound/jack-output.cpp +++ b/src/proc/play/sound/jack-output.cpp @@ -22,7 +22,9 @@ /** @file jack-output.cpp - ** TODO jack-output.cpp + ** + ** @todo empty placeholder: yes we will support Jack Audio! + ** */ diff --git a/src/proc/play/sound/jack-output.hpp b/src/proc/play/sound/jack-output.hpp index d793662d3..4aa50f4d2 100644 --- a/src/proc/play/sound/jack-output.hpp +++ b/src/proc/play/sound/jack-output.hpp @@ -21,7 +21,9 @@ */ /** @file jack-output.hpp - ** + ** + ** @todo empty placeholder to underpin the claim: yes we will support Jack Audio! + ** ** @see lumiera::Display ** @see lumiera::DummyPlayer ** @see gui::PlaybackController usage example diff --git a/src/proc/play/timings.cpp b/src/proc/play/timings.cpp index 2f3ab126d..b3b631502 100644 --- a/src/proc/play/timings.cpp +++ b/src/proc/play/timings.cpp @@ -22,7 +22,11 @@ /** @file timings.cpp - ** TODO timings.cpp + ** Implementation of a data tuple for timing specification. + ** A Timings record represents a constraint on playback, and will be + ** used to organise and the calculations necessary to generate the data. + ** Especially, a Timings record serves to establish a relation to an externally + ** fixed time grid or time source. */ From 24b3bec4bee5e6fa7e9fa487afb02383c4bf31e2 Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Wed, 22 Feb 2017 01:54:20 +0100 Subject: [PATCH 23/26] Doxygen: prepare all unit tests for inclusion in the documentation Doxygen will only process files with a @file documentation comment. Up to now, none of our test code has such a comment, preventing the cross-links to unit tests from working. This is unfortunate, since unit tests, and even the code comments there, can be considered as the most useful form of technical documentation. Thus I'll start an initiative to fill in those missing comments automatically --- tests/backend/sync-classlock-test.cpp | 4 ++-- tests/backend/sync-locking-test.cpp | 4 ++-- tests/backend/sync-timedwait-test.cpp | 4 ++-- tests/backend/sync-waiting-test.cpp | 4 ++-- tests/backend/test-filedescriptors.c | 2 +- tests/backend/test-filehandles.c | 2 +- tests/backend/test-fileheader.c | 2 +- tests/backend/test-filemmap.c | 2 +- tests/backend/test-resourcecollector.c | 2 +- tests/backend/test-threadpool.c | 2 +- tests/backend/test-threads.c | 2 +- tests/backend/thread-local-test.cpp | 4 ++-- tests/backend/thread-wrapper-join-test.cpp | 4 ++-- tests/backend/thread-wrapper-test.cpp | 4 ++-- tests/basics/diagnostic-context-test.cpp | 4 ++-- tests/basics/streamtypebasicstest.cpp | 4 ++-- tests/basics/streamtypelifecycletest.cpp | 4 ++-- tests/basics/teststreamtypes.hpp | 4 ++-- tests/basics/time/digxel-configurations-test.cpp | 4 ++-- tests/basics/time/digxel-test.cpp | 4 ++-- tests/basics/time/format-support-test.cpp | 4 ++-- tests/basics/time/quantiser-basics-test.cpp | 4 ++-- tests/basics/time/time-basics-test.cpp | 4 ++-- tests/basics/time/time-control-test.cpp | 4 ++-- tests/basics/time/time-formats-test.cpp | 4 ++-- tests/basics/time/time-mutation-test.cpp | 4 ++-- tests/basics/time/time-parsing-test.cpp | 4 ++-- tests/basics/time/time-quantisation-test.cpp | 4 ++-- tests/basics/time/time-value-test.cpp | 4 ++-- tests/basics/visitingtool-extended-test.cpp | 4 ++-- tests/basics/visitingtool-test.cpp | 4 ++-- tests/core/application/subsystem-runner-test.cpp | 4 ++-- tests/core/application/test-configloader.c | 2 +- tests/core/application/test-interfaces.c | 4 ++-- tests/core/backend/engine/dummy-job.cpp | 4 ++-- tests/core/backend/engine/dummy-job.hpp | 4 ++-- tests/core/backend/engine/job-hash-test.cpp | 4 ++-- tests/core/backend/engine/scheduler-interface-test.cpp | 4 ++-- tests/core/backend/media-access-mock-test.cpp | 4 ++-- tests/core/proc/asset/asset-category-test.cpp | 4 ++-- tests/core/proc/asset/basicpipetest.cpp | 4 ++-- tests/core/proc/asset/compoundmediatest.cpp | 4 ++-- tests/core/proc/asset/create-asset-test.cpp | 4 ++-- tests/core/proc/asset/deleteassettest.cpp | 4 ++-- tests/core/proc/asset/dependent-assets-test.cpp | 4 ++-- tests/core/proc/asset/entry-id-test.cpp | 4 ++-- tests/core/proc/asset/identityofassetstest.cpp | 4 ++-- tests/core/proc/asset/makecliptest.cpp | 4 ++-- tests/core/proc/asset/mediastructurequerytest.cpp | 4 ++-- tests/core/proc/asset/meta/time-grid-basics-test.cpp | 4 ++-- tests/core/proc/asset/orderingofassetstest.cpp | 4 ++-- tests/core/proc/asset/typed-id-test.cpp | 4 ++-- tests/core/proc/control/argument-tuple-accept-test.cpp | 4 ++-- tests/core/proc/control/command-argument-test.cpp | 4 ++-- tests/core/proc/control/command-basic-test.cpp | 4 ++-- tests/core/proc/control/command-binding-test.cpp | 4 ++-- tests/core/proc/control/command-clone-builder-test.cpp | 4 ++-- tests/core/proc/control/command-equality-test.cpp | 4 ++-- tests/core/proc/control/command-message-binding-test.cpp | 4 ++-- tests/core/proc/control/command-mutation-test.cpp | 4 ++-- tests/core/proc/control/command-registry-test.cpp | 4 ++-- tests/core/proc/control/command-use1-test.cpp | 4 ++-- tests/core/proc/control/command-use2-test.cpp | 4 ++-- tests/core/proc/control/command-use3-test.cpp | 4 ++-- tests/core/proc/control/handling-pattern-basics-test.cpp | 4 ++-- .../core/proc/control/handling-pattern-standard-impl-test.cpp | 4 ++-- tests/core/proc/control/memento-tie-test.cpp | 4 ++-- tests/core/proc/control/test-dummy-commands.cpp | 4 ++-- tests/core/proc/engine/buff-table-test.cpp | 4 ++-- tests/core/proc/engine/buffer-metadata-key-test.cpp | 4 ++-- tests/core/proc/engine/buffer-metadata-test.cpp | 4 ++-- tests/core/proc/engine/buffer-provider-protocol-test.cpp | 4 ++-- tests/core/proc/engine/calc-stream-test.cpp | 4 ++-- tests/core/proc/engine/dispatcher-interface-test.cpp | 4 ++-- tests/core/proc/engine/engine-interface-test.cpp | 4 ++-- tests/core/proc/engine/node-basic-test.cpp | 4 ++-- tests/core/proc/engine/node-fabrication-test.cpp | 4 ++-- tests/core/proc/engine/node-operation-test.cpp | 4 ++-- tests/core/proc/engine/node-source-test.cpp | 4 ++-- tests/core/proc/engine/testframe-test.cpp | 4 ++-- tests/core/proc/engine/tracking-heap-block-provider-test.cpp | 4 ++-- tests/core/proc/mobject/builder/buildertooltest.cpp | 4 ++-- tests/core/proc/mobject/builder/buildsegmenttest.cpp | 4 ++-- .../proc/mobject/builder/fixture-change-detector-test.cpp | 4 ++-- tests/core/proc/mobject/builder/model-port-registry-test.cpp | 4 ++-- .../proc/mobject/builder/segmentation-datastructure-test.cpp | 4 ++-- tests/core/proc/mobject/controller/rendersegmenttest.cpp | 4 ++-- tests/core/proc/mobject/mobject-interface-test.cpp | 4 ++-- tests/core/proc/mobject/mobject-ref-test.cpp | 4 ++-- tests/core/proc/mobject/output-mapping-test.cpp | 4 ++-- tests/core/proc/mobject/placement-basic-test.cpp | 4 ++-- tests/core/proc/mobject/placement-hierarchy-test.cpp | 4 ++-- tests/core/proc/mobject/placement-object-identity-test.cpp | 4 ++-- tests/core/proc/mobject/placement-ref-test.cpp | 4 ++-- tests/core/proc/mobject/session/addcliptest.cpp | 4 ++-- tests/core/proc/mobject/session/defs-manager-impl-test.cpp | 4 ++-- tests/core/proc/mobject/session/defs-manager-test.cpp | 4 ++-- tests/core/proc/mobject/session/defs-registry-impl-test.cpp | 4 ++-- tests/core/proc/mobject/session/deletecliptest.cpp | 4 ++-- .../core/proc/mobject/session/placement-index-query-test.cpp | 4 ++-- tests/core/proc/mobject/session/placement-index-test.cpp | 4 ++-- tests/core/proc/mobject/session/placement-scope-test.cpp | 4 ++-- tests/core/proc/mobject/session/query-focus-stack-test.cpp | 4 ++-- tests/core/proc/mobject/session/query-focus-test.cpp | 4 ++-- tests/core/proc/mobject/session/query-resolver-test.cpp | 4 ++-- tests/core/proc/mobject/session/rebuildfixturetest.cpp | 4 ++-- tests/core/proc/mobject/session/scope-path-test.cpp | 4 ++-- tests/core/proc/mobject/session/scope-query-test.cpp | 4 ++-- .../core/proc/mobject/session/session-element-query-test.cpp | 4 ++-- .../proc/mobject/session/session-element-tracker-test.cpp | 4 ++-- tests/core/proc/mobject/session/session-modify-parts-test.cpp | 4 ++-- .../core/proc/mobject/session/session-service-access-test.cpp | 4 ++-- tests/core/proc/mobject/session/session-structure-test.cpp | 4 ++-- tests/core/proc/mobject/session/sessionmanagertest.cpp | 4 ++-- .../proc/mobject/session/timeline-sequence-handling-test.cpp | 4 ++-- tests/core/proc/play/dummy-play-connection-test.cpp | 4 ++-- tests/core/proc/play/output-slot-protocol-test.cpp | 4 ++-- tests/core/proc/play/timing-constraints-test.cpp | 4 ++-- tests/gui/bus-term-test.cpp | 4 ++-- tests/gui/interact/state-map-grouping-storage-test.cpp | 4 ++-- tests/gui/test-gui-test.cpp | 4 ++-- tests/library/advice/advice-basics-test.cpp | 4 ++-- tests/library/advice/advice-binding-pattern-test.cpp | 4 ++-- tests/library/advice/advice-configuration-test.cpp | 4 ++-- tests/library/advice/advice-index-test.cpp | 4 ++-- tests/library/advice/advice-multiplicity-test.cpp | 4 ++-- tests/library/advice/advice-situations-test.cpp | 4 ++-- tests/library/allocation-cluster-test.cpp | 4 ++-- tests/library/app-config-test.cpp | 4 ++-- tests/library/bool-checkable-test.cpp | 4 ++-- tests/library/c-lib/test-errorstate.c | 2 +- tests/library/c-lib/test-llist.c | 2 +- tests/library/c-lib/test-locking.c | 2 +- tests/library/c-lib/test-luid.c | 2 +- tests/library/c-lib/test-mpool.c | 2 +- tests/library/c-lib/test-priqueue.c | 2 +- tests/library/c-lib/test-psplay.c | 2 +- tests/library/c-lib/test-safeclib.c | 2 +- tests/library/c-lib/test-slist.c | 2 +- tests/library/c-lib/test-time.c | 2 +- tests/library/cmdline-wrapper-test.cpp | 4 ++-- tests/library/custom-shared-ptr-test.cpp | 4 ++-- tests/library/del-stash-test.cpp | 4 ++-- tests/library/dependency-factory-test.cpp | 4 ++-- tests/library/diff/diff-complex-application-test.cpp | 4 ++-- tests/library/diff/diff-index-table-test.cpp | 4 ++-- tests/library/diff/diff-list-application-test.cpp | 4 ++-- tests/library/diff/diff-list-generation-test.cpp | 4 ++-- tests/library/diff/diff-tree-application-test.cpp | 4 ++-- tests/library/diff/gen-node-basic-test.cpp | 4 ++-- tests/library/diff/generic-record-representation-test.cpp | 4 ++-- tests/library/diff/tree-mutator-binding-test.cpp | 4 ++-- tests/library/diff/tree-mutator-test.cpp | 4 ++-- tests/library/exceptionerrortest.cpp | 4 ++-- tests/library/format-cout-test.cpp | 4 ++-- tests/library/format-helper-test.cpp | 4 ++-- tests/library/format-string-test.cpp | 4 ++-- tests/library/functor-util-test.cpp | 4 ++-- tests/library/hash-generator-test.cpp | 4 ++-- tests/library/hash-indexed-test.cpp | 4 ++-- tests/library/hash-standard-to-boost-bridge-test.cpp | 4 ++-- tests/library/helloworldtest.cpp | 4 ++-- tests/library/hierarchy-orientation-indicator-test.cpp | 4 ++-- tests/library/idi/generic-id-function-test.cpp | 4 ++-- tests/library/item-wrapper-test.cpp | 4 ++-- tests/library/iter-adapter-stl-test.cpp | 4 ++-- tests/library/iter-adapter-test.cpp | 4 ++-- tests/library/iter-cursor-test.cpp | 4 ++-- tests/library/iter-explorer-test.cpp | 4 ++-- tests/library/iter-queue-test.cpp | 4 ++-- tests/library/iter-source-test.cpp | 4 ++-- tests/library/iter-stack-test.cpp | 4 ++-- tests/library/itertools-test.cpp | 4 ++-- tests/library/lifecycletest.cpp | 4 ++-- tests/library/linked-elements-test.cpp | 4 ++-- tests/library/maybe-value-test.cpp | 4 ++-- tests/library/meta/access-casted-test.cpp | 4 ++-- tests/library/meta/duck-detector-test.cpp | 4 ++-- tests/library/meta/dummy-functions.hpp | 4 ++-- tests/library/meta/function-composition-test.cpp | 4 ++-- tests/library/meta/function-erasure-test.cpp | 4 ++-- tests/library/meta/generator-combinations-test.cpp | 4 ++-- tests/library/meta/iterable-classification-test.cpp | 4 ++-- tests/library/meta/meta-utils-test.cpp | 4 ++-- tests/library/meta/tuple-record-init-test.cpp | 4 ++-- tests/library/meta/type-demangling-test.cpp | 4 ++-- tests/library/meta/type-display-test.cpp | 4 ++-- tests/library/meta/typelist-test.cpp | 4 ++-- tests/library/meta/typelist-util-test.cpp | 4 ++-- tests/library/meta/virtual-copy-support-test.cpp | 4 ++-- tests/library/multifact-argument-test.cpp | 4 ++-- tests/library/multifact-singleton-test.cpp | 4 ++-- tests/library/multifact-test.cpp | 4 ++-- tests/library/null-value-test.cpp | 4 ++-- tests/library/opaque-holder-test.cpp | 4 ++-- tests/library/opaque-unchecked-buffer-test.cpp | 4 ++-- tests/library/optional-ref-test.cpp | 4 ++-- tests/library/polymorphic-value-test.cpp | 4 ++-- tests/library/query-text-test.cpp | 4 ++-- tests/library/query/query-utils-test.cpp | 4 ++-- tests/library/ref-array-test.cpp | 4 ++-- tests/library/removefromsettest.cpp | 4 ++-- tests/library/sanitised-identifier-test.cpp | 4 ++-- tests/library/scoped-collection-test.cpp | 4 ++-- tests/library/scoped-holder-test.cpp | 4 ++-- tests/library/scoped-holder-transfer-test.cpp | 4 ++-- tests/library/scoped-ptrvect-test.cpp | 4 ++-- tests/library/search-path-splitter-test.cpp | 4 ++-- tests/library/simple-allocator-test.cpp | 4 ++-- tests/library/singleton-subclass-test.cpp | 4 ++-- tests/library/singleton-test.cpp | 4 ++-- tests/library/singleton-testmock-test.cpp | 4 ++-- tests/library/sub-id-test.cpp | 4 ++-- tests/library/symbol-hashtable-test.cpp | 4 ++-- tests/library/symbol-test.cpp | 4 ++-- tests/library/test/test-event-log-test.cpp | 4 ++-- tests/library/test/test-helper-test.cpp | 4 ++-- tests/library/test/test-helper-variadic-test.cpp | 4 ++-- tests/library/test/test-option-test.cpp | 4 ++-- tests/library/typed-allocation-manager-test.cpp | 4 ++-- tests/library/unique-malloc-owner-test.cpp | 4 ++-- tests/library/util-collection-test.cpp | 4 ++-- tests/library/util-floordiv-test.cpp | 4 ++-- tests/library/util-floorwrap-test.cpp | 4 ++-- tests/library/util-foreach-test.cpp | 4 ++-- tests/library/variant-test.cpp | 4 ++-- tests/library/vector-transfer-test.cpp | 4 ++-- tests/library/verb-function-dispatch-test.cpp | 4 ++-- tests/operation/bugs/hello-bug-test.cpp | 4 ++-- 229 files changed, 440 insertions(+), 440 deletions(-) diff --git a/tests/backend/sync-classlock-test.cpp b/tests/backend/sync-classlock-test.cpp index 64b4f7736..94c6b7518 100644 --- a/tests/backend/sync-classlock-test.cpp +++ b/tests/backend/sync-classlock-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file sync-classlock-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/backend/sync-locking-test.cpp b/tests/backend/sync-locking-test.cpp index 8cc525f19..43166cdd3 100644 --- a/tests/backend/sync-locking-test.cpp +++ b/tests/backend/sync-locking-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file sync-locking-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/backend/sync-timedwait-test.cpp b/tests/backend/sync-timedwait-test.cpp index 46907d6b0..b06ba52dd 100644 --- a/tests/backend/sync-timedwait-test.cpp +++ b/tests/backend/sync-timedwait-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file sync-timedwait-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/backend/sync-waiting-test.cpp b/tests/backend/sync-waiting-test.cpp index a96e565e5..f88333df9 100644 --- a/tests/backend/sync-waiting-test.cpp +++ b/tests/backend/sync-waiting-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file sync-waiting-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/backend/test-filedescriptors.c b/tests/backend/test-filedescriptors.c index 5f03995e1..4b0cc7136 100644 --- a/tests/backend/test-filedescriptors.c +++ b/tests/backend/test-filedescriptors.c @@ -21,7 +21,7 @@ * *****************************************************/ /** @file §§§ - ** unit test TODO §§§ + ** unit test §§TODO§§ */ diff --git a/tests/backend/test-filehandles.c b/tests/backend/test-filehandles.c index 57b113984..3040881f3 100644 --- a/tests/backend/test-filehandles.c +++ b/tests/backend/test-filehandles.c @@ -21,7 +21,7 @@ * *****************************************************/ /** @file §§§ - ** unit test TODO §§§ + ** unit test §§TODO§§ */ diff --git a/tests/backend/test-fileheader.c b/tests/backend/test-fileheader.c index 7af584673..84045fef8 100644 --- a/tests/backend/test-fileheader.c +++ b/tests/backend/test-fileheader.c @@ -21,7 +21,7 @@ * *****************************************************/ /** @file §§§ - ** unit test TODO §§§ + ** unit test §§TODO§§ */ diff --git a/tests/backend/test-filemmap.c b/tests/backend/test-filemmap.c index 977401aed..dd1219f9b 100644 --- a/tests/backend/test-filemmap.c +++ b/tests/backend/test-filemmap.c @@ -21,7 +21,7 @@ * *****************************************************/ /** @file §§§ - ** unit test TODO §§§ + ** unit test §§TODO§§ */ diff --git a/tests/backend/test-resourcecollector.c b/tests/backend/test-resourcecollector.c index 583ca132d..267dab37c 100644 --- a/tests/backend/test-resourcecollector.c +++ b/tests/backend/test-resourcecollector.c @@ -21,7 +21,7 @@ * *****************************************************/ /** @file §§§ - ** unit test TODO §§§ + ** unit test §§TODO§§ */ diff --git a/tests/backend/test-threadpool.c b/tests/backend/test-threadpool.c index da329ed69..3c79f7e6c 100644 --- a/tests/backend/test-threadpool.c +++ b/tests/backend/test-threadpool.c @@ -21,7 +21,7 @@ * *****************************************************/ /** @file §§§ - ** unit test TODO §§§ + ** unit test §§TODO§§ */ diff --git a/tests/backend/test-threads.c b/tests/backend/test-threads.c index 6598c29e5..64a388a1e 100644 --- a/tests/backend/test-threads.c +++ b/tests/backend/test-threads.c @@ -21,7 +21,7 @@ * *****************************************************/ /** @file §§§ - ** unit test TODO §§§ + ** unit test §§TODO§§ */ diff --git a/tests/backend/thread-local-test.cpp b/tests/backend/thread-local-test.cpp index 2268728c2..e102423d9 100644 --- a/tests/backend/thread-local-test.cpp +++ b/tests/backend/thread-local-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file thread-local-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/backend/thread-wrapper-join-test.cpp b/tests/backend/thread-wrapper-join-test.cpp index 9650fd924..ae0fd7bbd 100644 --- a/tests/backend/thread-wrapper-join-test.cpp +++ b/tests/backend/thread-wrapper-join-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file thread-wrapper-join-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/backend/thread-wrapper-test.cpp b/tests/backend/thread-wrapper-test.cpp index 6f7854ebe..2d38c9493 100644 --- a/tests/backend/thread-wrapper-test.cpp +++ b/tests/backend/thread-wrapper-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file thread-wrapper-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/basics/diagnostic-context-test.cpp b/tests/basics/diagnostic-context-test.cpp index b39136724..c050d5742 100644 --- a/tests/basics/diagnostic-context-test.cpp +++ b/tests/basics/diagnostic-context-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file diagnostic-context-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/basics/streamtypebasicstest.cpp b/tests/basics/streamtypebasicstest.cpp index cf628514e..cc3170cbe 100644 --- a/tests/basics/streamtypebasicstest.cpp +++ b/tests/basics/streamtypebasicstest.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file streamtypebasicstest.cpp + ** unit test §§TODO§§ */ diff --git a/tests/basics/streamtypelifecycletest.cpp b/tests/basics/streamtypelifecycletest.cpp index a578bef53..43e1d4e4e 100644 --- a/tests/basics/streamtypelifecycletest.cpp +++ b/tests/basics/streamtypelifecycletest.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file streamtypelifecycletest.cpp + ** unit test §§TODO§§ */ diff --git a/tests/basics/teststreamtypes.hpp b/tests/basics/teststreamtypes.hpp index 5aac23dc2..bcb96df35 100644 --- a/tests/basics/teststreamtypes.hpp +++ b/tests/basics/teststreamtypes.hpp @@ -20,8 +20,8 @@ */ -/** @file §§§ - ** unit test TODO §§§ +/** @file teststreamtypes.hpp + ** Unit test helper to create fake streamtype information */ diff --git a/tests/basics/time/digxel-configurations-test.cpp b/tests/basics/time/digxel-configurations-test.cpp index 0101536a4..4a096ac37 100644 --- a/tests/basics/time/digxel-configurations-test.cpp +++ b/tests/basics/time/digxel-configurations-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file digxel-configurations-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/basics/time/digxel-test.cpp b/tests/basics/time/digxel-test.cpp index 2ff4d98af..74ca56d6c 100644 --- a/tests/basics/time/digxel-test.cpp +++ b/tests/basics/time/digxel-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file digxel-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/basics/time/format-support-test.cpp b/tests/basics/time/format-support-test.cpp index 46c945006..39361eca7 100644 --- a/tests/basics/time/format-support-test.cpp +++ b/tests/basics/time/format-support-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file format-support-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/basics/time/quantiser-basics-test.cpp b/tests/basics/time/quantiser-basics-test.cpp index 98548eeaf..996f2c122 100644 --- a/tests/basics/time/quantiser-basics-test.cpp +++ b/tests/basics/time/quantiser-basics-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file quantiser-basics-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/basics/time/time-basics-test.cpp b/tests/basics/time/time-basics-test.cpp index d49eebd1a..3fb60b074 100644 --- a/tests/basics/time/time-basics-test.cpp +++ b/tests/basics/time/time-basics-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file time-basics-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/basics/time/time-control-test.cpp b/tests/basics/time/time-control-test.cpp index 0db230cc8..6e9e4f217 100644 --- a/tests/basics/time/time-control-test.cpp +++ b/tests/basics/time/time-control-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file time-control-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/basics/time/time-formats-test.cpp b/tests/basics/time/time-formats-test.cpp index 45d0780e6..b54564e21 100644 --- a/tests/basics/time/time-formats-test.cpp +++ b/tests/basics/time/time-formats-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file time-formats-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/basics/time/time-mutation-test.cpp b/tests/basics/time/time-mutation-test.cpp index e8f02fce0..7bf00c6ff 100644 --- a/tests/basics/time/time-mutation-test.cpp +++ b/tests/basics/time/time-mutation-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file time-mutation-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/basics/time/time-parsing-test.cpp b/tests/basics/time/time-parsing-test.cpp index 10509fac8..d077c648c 100644 --- a/tests/basics/time/time-parsing-test.cpp +++ b/tests/basics/time/time-parsing-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file time-parsing-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/basics/time/time-quantisation-test.cpp b/tests/basics/time/time-quantisation-test.cpp index c8fad87f2..dc7d5ae1d 100644 --- a/tests/basics/time/time-quantisation-test.cpp +++ b/tests/basics/time/time-quantisation-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file time-quantisation-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/basics/time/time-value-test.cpp b/tests/basics/time/time-value-test.cpp index aa6a2a12b..fdd6d817e 100644 --- a/tests/basics/time/time-value-test.cpp +++ b/tests/basics/time/time-value-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file time-value-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/basics/visitingtool-extended-test.cpp b/tests/basics/visitingtool-extended-test.cpp index 7cb6c621e..e0550d26c 100644 --- a/tests/basics/visitingtool-extended-test.cpp +++ b/tests/basics/visitingtool-extended-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file visitingtool-extended-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/basics/visitingtool-test.cpp b/tests/basics/visitingtool-test.cpp index bfeb575f4..5c799ae74 100644 --- a/tests/basics/visitingtool-test.cpp +++ b/tests/basics/visitingtool-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file visitingtool-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/application/subsystem-runner-test.cpp b/tests/core/application/subsystem-runner-test.cpp index bf19da6d1..cb565699b 100644 --- a/tests/core/application/subsystem-runner-test.cpp +++ b/tests/core/application/subsystem-runner-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file subsystem-runner-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/application/test-configloader.c b/tests/core/application/test-configloader.c index 1ef7c2c7f..e9ab6a21b 100644 --- a/tests/core/application/test-configloader.c +++ b/tests/core/application/test-configloader.c @@ -22,7 +22,7 @@ * *****************************************************/ /** @file §§§ - ** unit test TODO §§§ + ** unit test §§TODO§§ */ diff --git a/tests/core/application/test-interfaces.c b/tests/core/application/test-interfaces.c index b24b9738a..1acfc51f3 100644 --- a/tests/core/application/test-interfaces.c +++ b/tests/core/application/test-interfaces.c @@ -21,7 +21,7 @@ * *****************************************************/ /** @file §§§ - ** unit test TODO §§§ + ** unit test §§TODO§§ */ @@ -32,7 +32,7 @@ #include "common/config-interface.h" #include "lib/test/test.h" -#include "interface/say_hello.h" +#include "interface/say-hello.h" /* define 2 example interfaces diff --git a/tests/core/backend/engine/dummy-job.cpp b/tests/core/backend/engine/dummy-job.cpp index 7cbd639fd..97aea2348 100644 --- a/tests/core/backend/engine/dummy-job.cpp +++ b/tests/core/backend/engine/dummy-job.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file dummy-job.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/backend/engine/dummy-job.hpp b/tests/core/backend/engine/dummy-job.hpp index 217f0ce80..b18571e10 100644 --- a/tests/core/backend/engine/dummy-job.hpp +++ b/tests/core/backend/engine/dummy-job.hpp @@ -20,8 +20,8 @@ */ -/** @file §§§ - ** unit test TODO §§§ +/** @file dummy-job.hpp + ** Unit test helper to generate dummy render jobs */ diff --git a/tests/core/backend/engine/job-hash-test.cpp b/tests/core/backend/engine/job-hash-test.cpp index f59c9c349..02c0ed407 100644 --- a/tests/core/backend/engine/job-hash-test.cpp +++ b/tests/core/backend/engine/job-hash-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file job-hash-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/backend/engine/scheduler-interface-test.cpp b/tests/core/backend/engine/scheduler-interface-test.cpp index a5ef297c9..cd16e19b5 100644 --- a/tests/core/backend/engine/scheduler-interface-test.cpp +++ b/tests/core/backend/engine/scheduler-interface-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file scheduler-interface-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/backend/media-access-mock-test.cpp b/tests/core/backend/media-access-mock-test.cpp index ec018b900..3c5eb06bb 100644 --- a/tests/core/backend/media-access-mock-test.cpp +++ b/tests/core/backend/media-access-mock-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file media-access-mock-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/asset/asset-category-test.cpp b/tests/core/proc/asset/asset-category-test.cpp index 91bb00e24..5206e9d7e 100644 --- a/tests/core/proc/asset/asset-category-test.cpp +++ b/tests/core/proc/asset/asset-category-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file asset-category-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/asset/basicpipetest.cpp b/tests/core/proc/asset/basicpipetest.cpp index 56e94b451..047ea64b0 100644 --- a/tests/core/proc/asset/basicpipetest.cpp +++ b/tests/core/proc/asset/basicpipetest.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file basicpipetest.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/asset/compoundmediatest.cpp b/tests/core/proc/asset/compoundmediatest.cpp index 166cb6c89..c4f1d9936 100644 --- a/tests/core/proc/asset/compoundmediatest.cpp +++ b/tests/core/proc/asset/compoundmediatest.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file compoundmediatest.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/asset/create-asset-test.cpp b/tests/core/proc/asset/create-asset-test.cpp index eaecfee72..b9bd46bd4 100644 --- a/tests/core/proc/asset/create-asset-test.cpp +++ b/tests/core/proc/asset/create-asset-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file create-asset-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/asset/deleteassettest.cpp b/tests/core/proc/asset/deleteassettest.cpp index 1f539bd70..75683baa7 100644 --- a/tests/core/proc/asset/deleteassettest.cpp +++ b/tests/core/proc/asset/deleteassettest.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file deleteassettest.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/asset/dependent-assets-test.cpp b/tests/core/proc/asset/dependent-assets-test.cpp index 6f40dfde4..e79df7ea7 100644 --- a/tests/core/proc/asset/dependent-assets-test.cpp +++ b/tests/core/proc/asset/dependent-assets-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file dependent-assets-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/asset/entry-id-test.cpp b/tests/core/proc/asset/entry-id-test.cpp index 1d239b2d8..80cce133d 100644 --- a/tests/core/proc/asset/entry-id-test.cpp +++ b/tests/core/proc/asset/entry-id-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file entry-id-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/asset/identityofassetstest.cpp b/tests/core/proc/asset/identityofassetstest.cpp index e0daef0c5..72af899a6 100644 --- a/tests/core/proc/asset/identityofassetstest.cpp +++ b/tests/core/proc/asset/identityofassetstest.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file identityofassetstest.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/asset/makecliptest.cpp b/tests/core/proc/asset/makecliptest.cpp index 74faa644e..93170b2db 100644 --- a/tests/core/proc/asset/makecliptest.cpp +++ b/tests/core/proc/asset/makecliptest.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file makecliptest.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/asset/mediastructurequerytest.cpp b/tests/core/proc/asset/mediastructurequerytest.cpp index e07142718..b5bb31f3e 100644 --- a/tests/core/proc/asset/mediastructurequerytest.cpp +++ b/tests/core/proc/asset/mediastructurequerytest.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file mediastructurequerytest.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/asset/meta/time-grid-basics-test.cpp b/tests/core/proc/asset/meta/time-grid-basics-test.cpp index 019c07433..055474f03 100644 --- a/tests/core/proc/asset/meta/time-grid-basics-test.cpp +++ b/tests/core/proc/asset/meta/time-grid-basics-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file time-grid-basics-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/asset/orderingofassetstest.cpp b/tests/core/proc/asset/orderingofassetstest.cpp index 411d160bf..652d147ea 100644 --- a/tests/core/proc/asset/orderingofassetstest.cpp +++ b/tests/core/proc/asset/orderingofassetstest.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file orderingofassetstest.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/asset/typed-id-test.cpp b/tests/core/proc/asset/typed-id-test.cpp index 7d3e2c0d9..93cc3049e 100644 --- a/tests/core/proc/asset/typed-id-test.cpp +++ b/tests/core/proc/asset/typed-id-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file typed-id-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/control/argument-tuple-accept-test.cpp b/tests/core/proc/control/argument-tuple-accept-test.cpp index b1c402b4c..59017628c 100644 --- a/tests/core/proc/control/argument-tuple-accept-test.cpp +++ b/tests/core/proc/control/argument-tuple-accept-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file argument-tuple-accept-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/control/command-argument-test.cpp b/tests/core/proc/control/command-argument-test.cpp index 47b7d7971..cc7e81c0b 100644 --- a/tests/core/proc/control/command-argument-test.cpp +++ b/tests/core/proc/control/command-argument-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file command-argument-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/control/command-basic-test.cpp b/tests/core/proc/control/command-basic-test.cpp index 3edb79b7b..e6523387f 100644 --- a/tests/core/proc/control/command-basic-test.cpp +++ b/tests/core/proc/control/command-basic-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file command-basic-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/control/command-binding-test.cpp b/tests/core/proc/control/command-binding-test.cpp index 5a4e75387..6f341050b 100644 --- a/tests/core/proc/control/command-binding-test.cpp +++ b/tests/core/proc/control/command-binding-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file command-binding-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/control/command-clone-builder-test.cpp b/tests/core/proc/control/command-clone-builder-test.cpp index 6d0c3e636..7d19baa50 100644 --- a/tests/core/proc/control/command-clone-builder-test.cpp +++ b/tests/core/proc/control/command-clone-builder-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file command-clone-builder-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/control/command-equality-test.cpp b/tests/core/proc/control/command-equality-test.cpp index cc8ed71f1..a240950e1 100644 --- a/tests/core/proc/control/command-equality-test.cpp +++ b/tests/core/proc/control/command-equality-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file command-equality-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/control/command-message-binding-test.cpp b/tests/core/proc/control/command-message-binding-test.cpp index 32c011e5c..c073bd5ae 100644 --- a/tests/core/proc/control/command-message-binding-test.cpp +++ b/tests/core/proc/control/command-message-binding-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file command-message-binding-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/control/command-mutation-test.cpp b/tests/core/proc/control/command-mutation-test.cpp index c839c37fb..2c877f55c 100644 --- a/tests/core/proc/control/command-mutation-test.cpp +++ b/tests/core/proc/control/command-mutation-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file command-mutation-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/control/command-registry-test.cpp b/tests/core/proc/control/command-registry-test.cpp index 59a4c2c13..bcfc2b98b 100644 --- a/tests/core/proc/control/command-registry-test.cpp +++ b/tests/core/proc/control/command-registry-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file command-registry-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/control/command-use1-test.cpp b/tests/core/proc/control/command-use1-test.cpp index 05be504a4..c035760d5 100644 --- a/tests/core/proc/control/command-use1-test.cpp +++ b/tests/core/proc/control/command-use1-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file command-use1-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/control/command-use2-test.cpp b/tests/core/proc/control/command-use2-test.cpp index a2f107190..d988242c3 100644 --- a/tests/core/proc/control/command-use2-test.cpp +++ b/tests/core/proc/control/command-use2-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file command-use2-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/control/command-use3-test.cpp b/tests/core/proc/control/command-use3-test.cpp index 5c1a644d9..c31b5f988 100644 --- a/tests/core/proc/control/command-use3-test.cpp +++ b/tests/core/proc/control/command-use3-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file command-use3-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/control/handling-pattern-basics-test.cpp b/tests/core/proc/control/handling-pattern-basics-test.cpp index 732a68870..f18e7f44a 100644 --- a/tests/core/proc/control/handling-pattern-basics-test.cpp +++ b/tests/core/proc/control/handling-pattern-basics-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file handling-pattern-basics-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/control/handling-pattern-standard-impl-test.cpp b/tests/core/proc/control/handling-pattern-standard-impl-test.cpp index 8bae309a1..f1af4a298 100644 --- a/tests/core/proc/control/handling-pattern-standard-impl-test.cpp +++ b/tests/core/proc/control/handling-pattern-standard-impl-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file handling-pattern-standard-impl-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/control/memento-tie-test.cpp b/tests/core/proc/control/memento-tie-test.cpp index 44626a3a4..1ac4a2bea 100644 --- a/tests/core/proc/control/memento-tie-test.cpp +++ b/tests/core/proc/control/memento-tie-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file memento-tie-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/control/test-dummy-commands.cpp b/tests/core/proc/control/test-dummy-commands.cpp index af7d34948..2da0e4e7f 100644 --- a/tests/core/proc/control/test-dummy-commands.cpp +++ b/tests/core/proc/control/test-dummy-commands.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file test-dummy-commands.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/engine/buff-table-test.cpp b/tests/core/proc/engine/buff-table-test.cpp index 9faad747a..a9cac4693 100644 --- a/tests/core/proc/engine/buff-table-test.cpp +++ b/tests/core/proc/engine/buff-table-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file buff-table-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/engine/buffer-metadata-key-test.cpp b/tests/core/proc/engine/buffer-metadata-key-test.cpp index c9237d980..e34247c7b 100644 --- a/tests/core/proc/engine/buffer-metadata-key-test.cpp +++ b/tests/core/proc/engine/buffer-metadata-key-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file buffer-metadata-key-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/engine/buffer-metadata-test.cpp b/tests/core/proc/engine/buffer-metadata-test.cpp index 3ceb0b0f0..54619ac6e 100644 --- a/tests/core/proc/engine/buffer-metadata-test.cpp +++ b/tests/core/proc/engine/buffer-metadata-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file buffer-metadata-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/engine/buffer-provider-protocol-test.cpp b/tests/core/proc/engine/buffer-provider-protocol-test.cpp index 7c60d9d03..4833b36e5 100644 --- a/tests/core/proc/engine/buffer-provider-protocol-test.cpp +++ b/tests/core/proc/engine/buffer-provider-protocol-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file buffer-provider-protocol-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/engine/calc-stream-test.cpp b/tests/core/proc/engine/calc-stream-test.cpp index a557070f8..7c529c48b 100644 --- a/tests/core/proc/engine/calc-stream-test.cpp +++ b/tests/core/proc/engine/calc-stream-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file calc-stream-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/engine/dispatcher-interface-test.cpp b/tests/core/proc/engine/dispatcher-interface-test.cpp index 2498d7250..9e2c078b2 100644 --- a/tests/core/proc/engine/dispatcher-interface-test.cpp +++ b/tests/core/proc/engine/dispatcher-interface-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file dispatcher-interface-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/engine/engine-interface-test.cpp b/tests/core/proc/engine/engine-interface-test.cpp index d99ad0b1a..21f8b140f 100644 --- a/tests/core/proc/engine/engine-interface-test.cpp +++ b/tests/core/proc/engine/engine-interface-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file engine-interface-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/engine/node-basic-test.cpp b/tests/core/proc/engine/node-basic-test.cpp index d3e6f7bfb..eeb22bde3 100644 --- a/tests/core/proc/engine/node-basic-test.cpp +++ b/tests/core/proc/engine/node-basic-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file node-basic-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/engine/node-fabrication-test.cpp b/tests/core/proc/engine/node-fabrication-test.cpp index 302bec5ba..c9f39448d 100644 --- a/tests/core/proc/engine/node-fabrication-test.cpp +++ b/tests/core/proc/engine/node-fabrication-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file node-fabrication-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/engine/node-operation-test.cpp b/tests/core/proc/engine/node-operation-test.cpp index e0e5bbd5c..e60807171 100644 --- a/tests/core/proc/engine/node-operation-test.cpp +++ b/tests/core/proc/engine/node-operation-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file node-operation-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/engine/node-source-test.cpp b/tests/core/proc/engine/node-source-test.cpp index 1fadd8244..81d74032c 100644 --- a/tests/core/proc/engine/node-source-test.cpp +++ b/tests/core/proc/engine/node-source-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file node-source-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/engine/testframe-test.cpp b/tests/core/proc/engine/testframe-test.cpp index 79419fe07..10d4cbef6 100644 --- a/tests/core/proc/engine/testframe-test.cpp +++ b/tests/core/proc/engine/testframe-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file testframe-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/engine/tracking-heap-block-provider-test.cpp b/tests/core/proc/engine/tracking-heap-block-provider-test.cpp index 70c515b92..40b68b720 100644 --- a/tests/core/proc/engine/tracking-heap-block-provider-test.cpp +++ b/tests/core/proc/engine/tracking-heap-block-provider-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file tracking-heap-block-provider-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/builder/buildertooltest.cpp b/tests/core/proc/mobject/builder/buildertooltest.cpp index 5bd7a8f96..49a2baa2d 100644 --- a/tests/core/proc/mobject/builder/buildertooltest.cpp +++ b/tests/core/proc/mobject/builder/buildertooltest.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file buildertooltest.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/builder/buildsegmenttest.cpp b/tests/core/proc/mobject/builder/buildsegmenttest.cpp index 3d94a2e00..aa0c1fff1 100644 --- a/tests/core/proc/mobject/builder/buildsegmenttest.cpp +++ b/tests/core/proc/mobject/builder/buildsegmenttest.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file buildsegmenttest.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/builder/fixture-change-detector-test.cpp b/tests/core/proc/mobject/builder/fixture-change-detector-test.cpp index dc3759678..e1dd1cd6f 100644 --- a/tests/core/proc/mobject/builder/fixture-change-detector-test.cpp +++ b/tests/core/proc/mobject/builder/fixture-change-detector-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file fixture-change-detector-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/builder/model-port-registry-test.cpp b/tests/core/proc/mobject/builder/model-port-registry-test.cpp index d31915a9e..304c2d7b3 100644 --- a/tests/core/proc/mobject/builder/model-port-registry-test.cpp +++ b/tests/core/proc/mobject/builder/model-port-registry-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file model-port-registry-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/builder/segmentation-datastructure-test.cpp b/tests/core/proc/mobject/builder/segmentation-datastructure-test.cpp index b08d5c24f..25ac985f8 100644 --- a/tests/core/proc/mobject/builder/segmentation-datastructure-test.cpp +++ b/tests/core/proc/mobject/builder/segmentation-datastructure-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file segmentation-datastructure-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/controller/rendersegmenttest.cpp b/tests/core/proc/mobject/controller/rendersegmenttest.cpp index 91795db0c..44b35ded7 100644 --- a/tests/core/proc/mobject/controller/rendersegmenttest.cpp +++ b/tests/core/proc/mobject/controller/rendersegmenttest.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file rendersegmenttest.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/mobject-interface-test.cpp b/tests/core/proc/mobject/mobject-interface-test.cpp index 54791cc13..d7cf0fe4f 100644 --- a/tests/core/proc/mobject/mobject-interface-test.cpp +++ b/tests/core/proc/mobject/mobject-interface-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file mobject-interface-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/mobject-ref-test.cpp b/tests/core/proc/mobject/mobject-ref-test.cpp index 5b3196efb..ab219b8c2 100644 --- a/tests/core/proc/mobject/mobject-ref-test.cpp +++ b/tests/core/proc/mobject/mobject-ref-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file mobject-ref-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/output-mapping-test.cpp b/tests/core/proc/mobject/output-mapping-test.cpp index ea4124859..3156759de 100644 --- a/tests/core/proc/mobject/output-mapping-test.cpp +++ b/tests/core/proc/mobject/output-mapping-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file output-mapping-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/placement-basic-test.cpp b/tests/core/proc/mobject/placement-basic-test.cpp index a83bb1368..e31276f24 100644 --- a/tests/core/proc/mobject/placement-basic-test.cpp +++ b/tests/core/proc/mobject/placement-basic-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file placement-basic-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/placement-hierarchy-test.cpp b/tests/core/proc/mobject/placement-hierarchy-test.cpp index 3ae1c80ed..ce19aa31d 100644 --- a/tests/core/proc/mobject/placement-hierarchy-test.cpp +++ b/tests/core/proc/mobject/placement-hierarchy-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file placement-hierarchy-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/placement-object-identity-test.cpp b/tests/core/proc/mobject/placement-object-identity-test.cpp index 080fa2b89..9298e6400 100644 --- a/tests/core/proc/mobject/placement-object-identity-test.cpp +++ b/tests/core/proc/mobject/placement-object-identity-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file placement-object-identity-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/placement-ref-test.cpp b/tests/core/proc/mobject/placement-ref-test.cpp index 5062af9ad..b5c239524 100644 --- a/tests/core/proc/mobject/placement-ref-test.cpp +++ b/tests/core/proc/mobject/placement-ref-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file placement-ref-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/session/addcliptest.cpp b/tests/core/proc/mobject/session/addcliptest.cpp index 2ed241473..928c40238 100644 --- a/tests/core/proc/mobject/session/addcliptest.cpp +++ b/tests/core/proc/mobject/session/addcliptest.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file addcliptest.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/session/defs-manager-impl-test.cpp b/tests/core/proc/mobject/session/defs-manager-impl-test.cpp index fbf32ac25..ec249a693 100644 --- a/tests/core/proc/mobject/session/defs-manager-impl-test.cpp +++ b/tests/core/proc/mobject/session/defs-manager-impl-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file defs-manager-impl-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/session/defs-manager-test.cpp b/tests/core/proc/mobject/session/defs-manager-test.cpp index 61427b3aa..5dbe64307 100644 --- a/tests/core/proc/mobject/session/defs-manager-test.cpp +++ b/tests/core/proc/mobject/session/defs-manager-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file defs-manager-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/session/defs-registry-impl-test.cpp b/tests/core/proc/mobject/session/defs-registry-impl-test.cpp index 212fd1bf1..c8345e42b 100644 --- a/tests/core/proc/mobject/session/defs-registry-impl-test.cpp +++ b/tests/core/proc/mobject/session/defs-registry-impl-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file defs-registry-impl-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/session/deletecliptest.cpp b/tests/core/proc/mobject/session/deletecliptest.cpp index 8b0c046f9..945ad6b88 100644 --- a/tests/core/proc/mobject/session/deletecliptest.cpp +++ b/tests/core/proc/mobject/session/deletecliptest.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file deletecliptest.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/session/placement-index-query-test.cpp b/tests/core/proc/mobject/session/placement-index-query-test.cpp index 8932652bc..285c950a5 100644 --- a/tests/core/proc/mobject/session/placement-index-query-test.cpp +++ b/tests/core/proc/mobject/session/placement-index-query-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file placement-index-query-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/session/placement-index-test.cpp b/tests/core/proc/mobject/session/placement-index-test.cpp index 8b4b11fe3..f7718cea3 100644 --- a/tests/core/proc/mobject/session/placement-index-test.cpp +++ b/tests/core/proc/mobject/session/placement-index-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file placement-index-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/session/placement-scope-test.cpp b/tests/core/proc/mobject/session/placement-scope-test.cpp index d27331dbd..d969e406a 100644 --- a/tests/core/proc/mobject/session/placement-scope-test.cpp +++ b/tests/core/proc/mobject/session/placement-scope-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file placement-scope-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/session/query-focus-stack-test.cpp b/tests/core/proc/mobject/session/query-focus-stack-test.cpp index ffa34b5ee..bcc3d0515 100644 --- a/tests/core/proc/mobject/session/query-focus-stack-test.cpp +++ b/tests/core/proc/mobject/session/query-focus-stack-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file query-focus-stack-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/session/query-focus-test.cpp b/tests/core/proc/mobject/session/query-focus-test.cpp index 2d5359bc9..5ba8561a9 100644 --- a/tests/core/proc/mobject/session/query-focus-test.cpp +++ b/tests/core/proc/mobject/session/query-focus-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file query-focus-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/session/query-resolver-test.cpp b/tests/core/proc/mobject/session/query-resolver-test.cpp index 15d478c6b..680fc5889 100644 --- a/tests/core/proc/mobject/session/query-resolver-test.cpp +++ b/tests/core/proc/mobject/session/query-resolver-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file query-resolver-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/session/rebuildfixturetest.cpp b/tests/core/proc/mobject/session/rebuildfixturetest.cpp index 2abd43d02..208c69fba 100644 --- a/tests/core/proc/mobject/session/rebuildfixturetest.cpp +++ b/tests/core/proc/mobject/session/rebuildfixturetest.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file rebuildfixturetest.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/session/scope-path-test.cpp b/tests/core/proc/mobject/session/scope-path-test.cpp index 1bf19fd84..183c704a0 100644 --- a/tests/core/proc/mobject/session/scope-path-test.cpp +++ b/tests/core/proc/mobject/session/scope-path-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file scope-path-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/session/scope-query-test.cpp b/tests/core/proc/mobject/session/scope-query-test.cpp index a56a7f76a..b2603018a 100644 --- a/tests/core/proc/mobject/session/scope-query-test.cpp +++ b/tests/core/proc/mobject/session/scope-query-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file scope-query-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/session/session-element-query-test.cpp b/tests/core/proc/mobject/session/session-element-query-test.cpp index fd59eb81f..95985742d 100644 --- a/tests/core/proc/mobject/session/session-element-query-test.cpp +++ b/tests/core/proc/mobject/session/session-element-query-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file session-element-query-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/session/session-element-tracker-test.cpp b/tests/core/proc/mobject/session/session-element-tracker-test.cpp index 888760f5d..fd1ec184d 100644 --- a/tests/core/proc/mobject/session/session-element-tracker-test.cpp +++ b/tests/core/proc/mobject/session/session-element-tracker-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file session-element-tracker-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/session/session-modify-parts-test.cpp b/tests/core/proc/mobject/session/session-modify-parts-test.cpp index dfa87ba7a..a0ea1dde2 100644 --- a/tests/core/proc/mobject/session/session-modify-parts-test.cpp +++ b/tests/core/proc/mobject/session/session-modify-parts-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file session-modify-parts-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/session/session-service-access-test.cpp b/tests/core/proc/mobject/session/session-service-access-test.cpp index f5d16d99d..e62437323 100644 --- a/tests/core/proc/mobject/session/session-service-access-test.cpp +++ b/tests/core/proc/mobject/session/session-service-access-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file session-service-access-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/session/session-structure-test.cpp b/tests/core/proc/mobject/session/session-structure-test.cpp index f7fd4f978..d742c65dd 100644 --- a/tests/core/proc/mobject/session/session-structure-test.cpp +++ b/tests/core/proc/mobject/session/session-structure-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file session-structure-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/session/sessionmanagertest.cpp b/tests/core/proc/mobject/session/sessionmanagertest.cpp index f0736a501..866d54570 100644 --- a/tests/core/proc/mobject/session/sessionmanagertest.cpp +++ b/tests/core/proc/mobject/session/sessionmanagertest.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file sessionmanagertest.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/mobject/session/timeline-sequence-handling-test.cpp b/tests/core/proc/mobject/session/timeline-sequence-handling-test.cpp index 4909379a0..d07df4039 100644 --- a/tests/core/proc/mobject/session/timeline-sequence-handling-test.cpp +++ b/tests/core/proc/mobject/session/timeline-sequence-handling-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file timeline-sequence-handling-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/play/dummy-play-connection-test.cpp b/tests/core/proc/play/dummy-play-connection-test.cpp index b6e326f44..856bc3d4c 100644 --- a/tests/core/proc/play/dummy-play-connection-test.cpp +++ b/tests/core/proc/play/dummy-play-connection-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file dummy-play-connection-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/play/output-slot-protocol-test.cpp b/tests/core/proc/play/output-slot-protocol-test.cpp index e04b1bd11..47f1eb81c 100644 --- a/tests/core/proc/play/output-slot-protocol-test.cpp +++ b/tests/core/proc/play/output-slot-protocol-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file output-slot-protocol-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/core/proc/play/timing-constraints-test.cpp b/tests/core/proc/play/timing-constraints-test.cpp index 349940390..336934391 100644 --- a/tests/core/proc/play/timing-constraints-test.cpp +++ b/tests/core/proc/play/timing-constraints-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file timing-constraints-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/gui/bus-term-test.cpp b/tests/gui/bus-term-test.cpp index b7ca88f49..697b54540 100644 --- a/tests/gui/bus-term-test.cpp +++ b/tests/gui/bus-term-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file bus-term-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/gui/interact/state-map-grouping-storage-test.cpp b/tests/gui/interact/state-map-grouping-storage-test.cpp index 0040ad415..1318e8fcc 100644 --- a/tests/gui/interact/state-map-grouping-storage-test.cpp +++ b/tests/gui/interact/state-map-grouping-storage-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file state-map-grouping-storage-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/gui/test-gui-test.cpp b/tests/gui/test-gui-test.cpp index d5268b9a8..3d90b3005 100644 --- a/tests/gui/test-gui-test.cpp +++ b/tests/gui/test-gui-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file test-gui-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/advice/advice-basics-test.cpp b/tests/library/advice/advice-basics-test.cpp index 6e989b6f5..814a958fa 100644 --- a/tests/library/advice/advice-basics-test.cpp +++ b/tests/library/advice/advice-basics-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file advice-basics-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/advice/advice-binding-pattern-test.cpp b/tests/library/advice/advice-binding-pattern-test.cpp index 9671ea1ff..b985e543e 100644 --- a/tests/library/advice/advice-binding-pattern-test.cpp +++ b/tests/library/advice/advice-binding-pattern-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file advice-binding-pattern-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/advice/advice-configuration-test.cpp b/tests/library/advice/advice-configuration-test.cpp index c8ff0d4e7..69733ffc4 100644 --- a/tests/library/advice/advice-configuration-test.cpp +++ b/tests/library/advice/advice-configuration-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file advice-configuration-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/advice/advice-index-test.cpp b/tests/library/advice/advice-index-test.cpp index 8db4ce983..19b919e12 100644 --- a/tests/library/advice/advice-index-test.cpp +++ b/tests/library/advice/advice-index-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file advice-index-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/advice/advice-multiplicity-test.cpp b/tests/library/advice/advice-multiplicity-test.cpp index b09f1e469..ab45743d5 100644 --- a/tests/library/advice/advice-multiplicity-test.cpp +++ b/tests/library/advice/advice-multiplicity-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file advice-multiplicity-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/advice/advice-situations-test.cpp b/tests/library/advice/advice-situations-test.cpp index 7f0d1b45a..63fe1a836 100644 --- a/tests/library/advice/advice-situations-test.cpp +++ b/tests/library/advice/advice-situations-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file advice-situations-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/allocation-cluster-test.cpp b/tests/library/allocation-cluster-test.cpp index 4dc49b8c8..f54daf12c 100644 --- a/tests/library/allocation-cluster-test.cpp +++ b/tests/library/allocation-cluster-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file allocation-cluster-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/app-config-test.cpp b/tests/library/app-config-test.cpp index 2a19305ee..eba0ac69b 100644 --- a/tests/library/app-config-test.cpp +++ b/tests/library/app-config-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file app-config-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/bool-checkable-test.cpp b/tests/library/bool-checkable-test.cpp index cb9cfede3..b258b15fb 100644 --- a/tests/library/bool-checkable-test.cpp +++ b/tests/library/bool-checkable-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file bool-checkable-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/c-lib/test-errorstate.c b/tests/library/c-lib/test-errorstate.c index 1b9a54ec8..080a4bdf0 100644 --- a/tests/library/c-lib/test-errorstate.c +++ b/tests/library/c-lib/test-errorstate.c @@ -21,7 +21,7 @@ * *****************************************************/ /** @file §§§ - ** unit test TODO §§§ + ** unit test §§TODO§§ */ diff --git a/tests/library/c-lib/test-llist.c b/tests/library/c-lib/test-llist.c index 26fce3751..2d1b5ceca 100644 --- a/tests/library/c-lib/test-llist.c +++ b/tests/library/c-lib/test-llist.c @@ -21,7 +21,7 @@ * *****************************************************/ /** @file §§§ - ** unit test TODO §§§ + ** unit test §§TODO§§ */ diff --git a/tests/library/c-lib/test-locking.c b/tests/library/c-lib/test-locking.c index 5c4da0538..f2601db22 100644 --- a/tests/library/c-lib/test-locking.c +++ b/tests/library/c-lib/test-locking.c @@ -21,7 +21,7 @@ * *****************************************************/ /** @file §§§ - ** unit test TODO §§§ + ** unit test §§TODO§§ */ diff --git a/tests/library/c-lib/test-luid.c b/tests/library/c-lib/test-luid.c index d87809168..01f26eef5 100644 --- a/tests/library/c-lib/test-luid.c +++ b/tests/library/c-lib/test-luid.c @@ -21,7 +21,7 @@ * *****************************************************/ /** @file §§§ - ** unit test TODO §§§ + ** unit test §§TODO§§ */ diff --git a/tests/library/c-lib/test-mpool.c b/tests/library/c-lib/test-mpool.c index 09331ad0b..a15e864a0 100644 --- a/tests/library/c-lib/test-mpool.c +++ b/tests/library/c-lib/test-mpool.c @@ -21,7 +21,7 @@ * *****************************************************/ /** @file §§§ - ** unit test TODO §§§ + ** unit test §§TODO§§ */ diff --git a/tests/library/c-lib/test-priqueue.c b/tests/library/c-lib/test-priqueue.c index 46589264f..b5c25e1b8 100644 --- a/tests/library/c-lib/test-priqueue.c +++ b/tests/library/c-lib/test-priqueue.c @@ -21,7 +21,7 @@ * *****************************************************/ /** @file §§§ - ** unit test TODO §§§ + ** unit test §§TODO§§ */ diff --git a/tests/library/c-lib/test-psplay.c b/tests/library/c-lib/test-psplay.c index 6cae14716..e8effdb19 100644 --- a/tests/library/c-lib/test-psplay.c +++ b/tests/library/c-lib/test-psplay.c @@ -21,7 +21,7 @@ * *****************************************************/ /** @file §§§ - ** unit test TODO §§§ + ** unit test §§TODO§§ */ diff --git a/tests/library/c-lib/test-safeclib.c b/tests/library/c-lib/test-safeclib.c index d6a322144..6de98c184 100644 --- a/tests/library/c-lib/test-safeclib.c +++ b/tests/library/c-lib/test-safeclib.c @@ -21,7 +21,7 @@ * *****************************************************/ /** @file §§§ - ** unit test TODO §§§ + ** unit test §§TODO§§ */ diff --git a/tests/library/c-lib/test-slist.c b/tests/library/c-lib/test-slist.c index 8b5a8a6a7..296a3ca8b 100644 --- a/tests/library/c-lib/test-slist.c +++ b/tests/library/c-lib/test-slist.c @@ -21,7 +21,7 @@ * *****************************************************/ /** @file §§§ - ** unit test TODO §§§ + ** unit test §§TODO§§ */ diff --git a/tests/library/c-lib/test-time.c b/tests/library/c-lib/test-time.c index 02ba321b0..ac31b798c 100644 --- a/tests/library/c-lib/test-time.c +++ b/tests/library/c-lib/test-time.c @@ -21,7 +21,7 @@ * *****************************************************/ /** @file §§§ - ** unit test TODO §§§ + ** unit test §§TODO§§ */ diff --git a/tests/library/cmdline-wrapper-test.cpp b/tests/library/cmdline-wrapper-test.cpp index 8ca8de8ad..1135faeb2 100644 --- a/tests/library/cmdline-wrapper-test.cpp +++ b/tests/library/cmdline-wrapper-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file cmdline-wrapper-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/custom-shared-ptr-test.cpp b/tests/library/custom-shared-ptr-test.cpp index 4ec7493ce..f26098165 100644 --- a/tests/library/custom-shared-ptr-test.cpp +++ b/tests/library/custom-shared-ptr-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file custom-shared-ptr-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/del-stash-test.cpp b/tests/library/del-stash-test.cpp index 28ff6dea4..26363dbff 100644 --- a/tests/library/del-stash-test.cpp +++ b/tests/library/del-stash-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file del-stash-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/dependency-factory-test.cpp b/tests/library/dependency-factory-test.cpp index 5df8937a9..106900df1 100644 --- a/tests/library/dependency-factory-test.cpp +++ b/tests/library/dependency-factory-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file dependency-factory-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/diff/diff-complex-application-test.cpp b/tests/library/diff/diff-complex-application-test.cpp index 22d711540..e5faa340b 100644 --- a/tests/library/diff/diff-complex-application-test.cpp +++ b/tests/library/diff/diff-complex-application-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file diff-complex-application-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/diff/diff-index-table-test.cpp b/tests/library/diff/diff-index-table-test.cpp index 01279b113..7bc618bdb 100644 --- a/tests/library/diff/diff-index-table-test.cpp +++ b/tests/library/diff/diff-index-table-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file diff-index-table-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/diff/diff-list-application-test.cpp b/tests/library/diff/diff-list-application-test.cpp index a87f98fed..86f580806 100644 --- a/tests/library/diff/diff-list-application-test.cpp +++ b/tests/library/diff/diff-list-application-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file diff-list-application-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/diff/diff-list-generation-test.cpp b/tests/library/diff/diff-list-generation-test.cpp index 0e7af8746..f6d0172c6 100644 --- a/tests/library/diff/diff-list-generation-test.cpp +++ b/tests/library/diff/diff-list-generation-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file diff-list-generation-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/diff/diff-tree-application-test.cpp b/tests/library/diff/diff-tree-application-test.cpp index d640925d0..412234f8d 100644 --- a/tests/library/diff/diff-tree-application-test.cpp +++ b/tests/library/diff/diff-tree-application-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file diff-tree-application-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/diff/gen-node-basic-test.cpp b/tests/library/diff/gen-node-basic-test.cpp index 5c043d573..adb65d6dc 100644 --- a/tests/library/diff/gen-node-basic-test.cpp +++ b/tests/library/diff/gen-node-basic-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file gen-node-basic-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/diff/generic-record-representation-test.cpp b/tests/library/diff/generic-record-representation-test.cpp index 562d917e7..79cae0cf3 100644 --- a/tests/library/diff/generic-record-representation-test.cpp +++ b/tests/library/diff/generic-record-representation-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file generic-record-representation-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/diff/tree-mutator-binding-test.cpp b/tests/library/diff/tree-mutator-binding-test.cpp index 4ad181975..8411b24e9 100644 --- a/tests/library/diff/tree-mutator-binding-test.cpp +++ b/tests/library/diff/tree-mutator-binding-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file tree-mutator-binding-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/diff/tree-mutator-test.cpp b/tests/library/diff/tree-mutator-test.cpp index 2cd8c7482..3b8533be3 100644 --- a/tests/library/diff/tree-mutator-test.cpp +++ b/tests/library/diff/tree-mutator-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file tree-mutator-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/exceptionerrortest.cpp b/tests/library/exceptionerrortest.cpp index 247458a5e..979117c50 100644 --- a/tests/library/exceptionerrortest.cpp +++ b/tests/library/exceptionerrortest.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file exceptionerrortest.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/format-cout-test.cpp b/tests/library/format-cout-test.cpp index ef020ebd9..4387f4322 100644 --- a/tests/library/format-cout-test.cpp +++ b/tests/library/format-cout-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file format-cout-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/format-helper-test.cpp b/tests/library/format-helper-test.cpp index 44a2f57c3..c548ab517 100644 --- a/tests/library/format-helper-test.cpp +++ b/tests/library/format-helper-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file format-helper-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/format-string-test.cpp b/tests/library/format-string-test.cpp index 2577588e0..f9b2377ac 100644 --- a/tests/library/format-string-test.cpp +++ b/tests/library/format-string-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file format-string-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/functor-util-test.cpp b/tests/library/functor-util-test.cpp index 6dda798be..81546bf75 100644 --- a/tests/library/functor-util-test.cpp +++ b/tests/library/functor-util-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file functor-util-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/hash-generator-test.cpp b/tests/library/hash-generator-test.cpp index 2a9be98d4..11d7fc782 100644 --- a/tests/library/hash-generator-test.cpp +++ b/tests/library/hash-generator-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file hash-generator-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/hash-indexed-test.cpp b/tests/library/hash-indexed-test.cpp index cba68e9f2..677fc6aa7 100644 --- a/tests/library/hash-indexed-test.cpp +++ b/tests/library/hash-indexed-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file hash-indexed-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/hash-standard-to-boost-bridge-test.cpp b/tests/library/hash-standard-to-boost-bridge-test.cpp index 97cd802b6..a1dda903e 100644 --- a/tests/library/hash-standard-to-boost-bridge-test.cpp +++ b/tests/library/hash-standard-to-boost-bridge-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file hash-standard-to-boost-bridge-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/helloworldtest.cpp b/tests/library/helloworldtest.cpp index e15c3368e..b14e46463 100644 --- a/tests/library/helloworldtest.cpp +++ b/tests/library/helloworldtest.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file helloworldtest.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/hierarchy-orientation-indicator-test.cpp b/tests/library/hierarchy-orientation-indicator-test.cpp index eac05f593..d55bed459 100644 --- a/tests/library/hierarchy-orientation-indicator-test.cpp +++ b/tests/library/hierarchy-orientation-indicator-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file hierarchy-orientation-indicator-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/idi/generic-id-function-test.cpp b/tests/library/idi/generic-id-function-test.cpp index e0da5427c..f1a0af92b 100644 --- a/tests/library/idi/generic-id-function-test.cpp +++ b/tests/library/idi/generic-id-function-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file generic-id-function-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/item-wrapper-test.cpp b/tests/library/item-wrapper-test.cpp index bc9eacff7..66a95f29c 100644 --- a/tests/library/item-wrapper-test.cpp +++ b/tests/library/item-wrapper-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file item-wrapper-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/iter-adapter-stl-test.cpp b/tests/library/iter-adapter-stl-test.cpp index 6c46abba7..8e6881299 100644 --- a/tests/library/iter-adapter-stl-test.cpp +++ b/tests/library/iter-adapter-stl-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file iter-adapter-stl-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/iter-adapter-test.cpp b/tests/library/iter-adapter-test.cpp index 4c7e2fd1a..8b604b8a7 100644 --- a/tests/library/iter-adapter-test.cpp +++ b/tests/library/iter-adapter-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file iter-adapter-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/iter-cursor-test.cpp b/tests/library/iter-cursor-test.cpp index 38d1eecec..57b9b0a00 100644 --- a/tests/library/iter-cursor-test.cpp +++ b/tests/library/iter-cursor-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file iter-cursor-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/iter-explorer-test.cpp b/tests/library/iter-explorer-test.cpp index ffd0f2cf8..4737912c0 100644 --- a/tests/library/iter-explorer-test.cpp +++ b/tests/library/iter-explorer-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file iter-explorer-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/iter-queue-test.cpp b/tests/library/iter-queue-test.cpp index ab0df58f2..8dcf8902a 100644 --- a/tests/library/iter-queue-test.cpp +++ b/tests/library/iter-queue-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file iter-queue-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/iter-source-test.cpp b/tests/library/iter-source-test.cpp index 4074436f0..895ae7450 100644 --- a/tests/library/iter-source-test.cpp +++ b/tests/library/iter-source-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file iter-source-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/iter-stack-test.cpp b/tests/library/iter-stack-test.cpp index fe41b7a28..455b851ca 100644 --- a/tests/library/iter-stack-test.cpp +++ b/tests/library/iter-stack-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file iter-stack-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/itertools-test.cpp b/tests/library/itertools-test.cpp index 1e7b91859..aabab2460 100644 --- a/tests/library/itertools-test.cpp +++ b/tests/library/itertools-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file itertools-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/lifecycletest.cpp b/tests/library/lifecycletest.cpp index 14669c345..34894349f 100644 --- a/tests/library/lifecycletest.cpp +++ b/tests/library/lifecycletest.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file lifecycletest.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/linked-elements-test.cpp b/tests/library/linked-elements-test.cpp index ce78c29c1..2e0a1d9b0 100644 --- a/tests/library/linked-elements-test.cpp +++ b/tests/library/linked-elements-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file linked-elements-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/maybe-value-test.cpp b/tests/library/maybe-value-test.cpp index 99f8f0171..83d59d3df 100644 --- a/tests/library/maybe-value-test.cpp +++ b/tests/library/maybe-value-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file maybe-value-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/meta/access-casted-test.cpp b/tests/library/meta/access-casted-test.cpp index 90fef0367..5b5724200 100644 --- a/tests/library/meta/access-casted-test.cpp +++ b/tests/library/meta/access-casted-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file access-casted-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/meta/duck-detector-test.cpp b/tests/library/meta/duck-detector-test.cpp index 89e5287bc..354420971 100644 --- a/tests/library/meta/duck-detector-test.cpp +++ b/tests/library/meta/duck-detector-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file duck-detector-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/meta/dummy-functions.hpp b/tests/library/meta/dummy-functions.hpp index 0650c547e..7cf523e4d 100644 --- a/tests/library/meta/dummy-functions.hpp +++ b/tests/library/meta/dummy-functions.hpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file dummy-functions.hpp + ** unit test §§TODO§§ */ diff --git a/tests/library/meta/function-composition-test.cpp b/tests/library/meta/function-composition-test.cpp index 16cf65cfb..10902db45 100644 --- a/tests/library/meta/function-composition-test.cpp +++ b/tests/library/meta/function-composition-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file function-composition-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/meta/function-erasure-test.cpp b/tests/library/meta/function-erasure-test.cpp index 712772312..fb0532d0d 100644 --- a/tests/library/meta/function-erasure-test.cpp +++ b/tests/library/meta/function-erasure-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file function-erasure-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/meta/generator-combinations-test.cpp b/tests/library/meta/generator-combinations-test.cpp index 629001e81..0d541d359 100644 --- a/tests/library/meta/generator-combinations-test.cpp +++ b/tests/library/meta/generator-combinations-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file generator-combinations-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/meta/iterable-classification-test.cpp b/tests/library/meta/iterable-classification-test.cpp index 681392401..a38a70316 100644 --- a/tests/library/meta/iterable-classification-test.cpp +++ b/tests/library/meta/iterable-classification-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file iterable-classification-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/meta/meta-utils-test.cpp b/tests/library/meta/meta-utils-test.cpp index 9de46d91f..3d2fcc3cc 100644 --- a/tests/library/meta/meta-utils-test.cpp +++ b/tests/library/meta/meta-utils-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file meta-utils-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/meta/tuple-record-init-test.cpp b/tests/library/meta/tuple-record-init-test.cpp index 92f468172..edbca2920 100644 --- a/tests/library/meta/tuple-record-init-test.cpp +++ b/tests/library/meta/tuple-record-init-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file tuple-record-init-test.cpp + ** unit test §§TODO§§ */ ///@file diff --git a/tests/library/meta/type-demangling-test.cpp b/tests/library/meta/type-demangling-test.cpp index 3eb1cfa29..b380f8ede 100644 --- a/tests/library/meta/type-demangling-test.cpp +++ b/tests/library/meta/type-demangling-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file type-demangling-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/meta/type-display-test.cpp b/tests/library/meta/type-display-test.cpp index 60565e275..ed22d4e53 100644 --- a/tests/library/meta/type-display-test.cpp +++ b/tests/library/meta/type-display-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file type-display-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/meta/typelist-test.cpp b/tests/library/meta/typelist-test.cpp index ffb307cc0..4a31dbcf2 100644 --- a/tests/library/meta/typelist-test.cpp +++ b/tests/library/meta/typelist-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file typelist-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/meta/typelist-util-test.cpp b/tests/library/meta/typelist-util-test.cpp index 6c9bdd79e..fb93a157d 100644 --- a/tests/library/meta/typelist-util-test.cpp +++ b/tests/library/meta/typelist-util-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file typelist-util-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/meta/virtual-copy-support-test.cpp b/tests/library/meta/virtual-copy-support-test.cpp index 4ca762b24..9adf6886a 100644 --- a/tests/library/meta/virtual-copy-support-test.cpp +++ b/tests/library/meta/virtual-copy-support-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file virtual-copy-support-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/multifact-argument-test.cpp b/tests/library/multifact-argument-test.cpp index f69244d76..ef30ccbf5 100644 --- a/tests/library/multifact-argument-test.cpp +++ b/tests/library/multifact-argument-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file multifact-argument-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/multifact-singleton-test.cpp b/tests/library/multifact-singleton-test.cpp index ade0f26d3..377303b17 100644 --- a/tests/library/multifact-singleton-test.cpp +++ b/tests/library/multifact-singleton-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file multifact-singleton-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/multifact-test.cpp b/tests/library/multifact-test.cpp index 3b2b99d83..f99b9d6fc 100644 --- a/tests/library/multifact-test.cpp +++ b/tests/library/multifact-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file multifact-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/null-value-test.cpp b/tests/library/null-value-test.cpp index 785991044..34d144788 100644 --- a/tests/library/null-value-test.cpp +++ b/tests/library/null-value-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file null-value-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/opaque-holder-test.cpp b/tests/library/opaque-holder-test.cpp index 4df609b04..daed90748 100644 --- a/tests/library/opaque-holder-test.cpp +++ b/tests/library/opaque-holder-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file opaque-holder-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/opaque-unchecked-buffer-test.cpp b/tests/library/opaque-unchecked-buffer-test.cpp index c8f0aeca5..d34876447 100644 --- a/tests/library/opaque-unchecked-buffer-test.cpp +++ b/tests/library/opaque-unchecked-buffer-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file opaque-unchecked-buffer-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/optional-ref-test.cpp b/tests/library/optional-ref-test.cpp index a568850ab..180fc2e77 100644 --- a/tests/library/optional-ref-test.cpp +++ b/tests/library/optional-ref-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file optional-ref-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/polymorphic-value-test.cpp b/tests/library/polymorphic-value-test.cpp index f824b0756..0be0be73b 100644 --- a/tests/library/polymorphic-value-test.cpp +++ b/tests/library/polymorphic-value-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file polymorphic-value-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/query-text-test.cpp b/tests/library/query-text-test.cpp index f7f9a3732..4bd09335f 100644 --- a/tests/library/query-text-test.cpp +++ b/tests/library/query-text-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file query-text-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/query/query-utils-test.cpp b/tests/library/query/query-utils-test.cpp index b25d4eed0..6d31f2a9d 100644 --- a/tests/library/query/query-utils-test.cpp +++ b/tests/library/query/query-utils-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file query-utils-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/ref-array-test.cpp b/tests/library/ref-array-test.cpp index 45980e1d0..4a0c2cc1c 100644 --- a/tests/library/ref-array-test.cpp +++ b/tests/library/ref-array-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file ref-array-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/removefromsettest.cpp b/tests/library/removefromsettest.cpp index 53ea9a2b2..5ac38aba9 100644 --- a/tests/library/removefromsettest.cpp +++ b/tests/library/removefromsettest.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file removefromsettest.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/sanitised-identifier-test.cpp b/tests/library/sanitised-identifier-test.cpp index e04288b72..47d24d680 100644 --- a/tests/library/sanitised-identifier-test.cpp +++ b/tests/library/sanitised-identifier-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file sanitised-identifier-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/scoped-collection-test.cpp b/tests/library/scoped-collection-test.cpp index 87168a723..38404b319 100644 --- a/tests/library/scoped-collection-test.cpp +++ b/tests/library/scoped-collection-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file scoped-collection-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/scoped-holder-test.cpp b/tests/library/scoped-holder-test.cpp index c3fe368f0..41850bffd 100644 --- a/tests/library/scoped-holder-test.cpp +++ b/tests/library/scoped-holder-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file scoped-holder-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/scoped-holder-transfer-test.cpp b/tests/library/scoped-holder-transfer-test.cpp index 41f972d56..cdc56870c 100644 --- a/tests/library/scoped-holder-transfer-test.cpp +++ b/tests/library/scoped-holder-transfer-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file scoped-holder-transfer-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/scoped-ptrvect-test.cpp b/tests/library/scoped-ptrvect-test.cpp index 0694b0538..f9027ba93 100644 --- a/tests/library/scoped-ptrvect-test.cpp +++ b/tests/library/scoped-ptrvect-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file scoped-ptrvect-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/search-path-splitter-test.cpp b/tests/library/search-path-splitter-test.cpp index 5d5d19eb8..6cb859623 100644 --- a/tests/library/search-path-splitter-test.cpp +++ b/tests/library/search-path-splitter-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file search-path-splitter-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/simple-allocator-test.cpp b/tests/library/simple-allocator-test.cpp index 019baf77c..c047de152 100644 --- a/tests/library/simple-allocator-test.cpp +++ b/tests/library/simple-allocator-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file simple-allocator-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/singleton-subclass-test.cpp b/tests/library/singleton-subclass-test.cpp index b661dcfd5..d3a188955 100644 --- a/tests/library/singleton-subclass-test.cpp +++ b/tests/library/singleton-subclass-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file singleton-subclass-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/singleton-test.cpp b/tests/library/singleton-test.cpp index 90ab20ba0..d356ff56d 100644 --- a/tests/library/singleton-test.cpp +++ b/tests/library/singleton-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file singleton-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/singleton-testmock-test.cpp b/tests/library/singleton-testmock-test.cpp index bf039c656..2c6cc8edb 100644 --- a/tests/library/singleton-testmock-test.cpp +++ b/tests/library/singleton-testmock-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file singleton-testmock-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/sub-id-test.cpp b/tests/library/sub-id-test.cpp index 39af39831..64f41650e 100644 --- a/tests/library/sub-id-test.cpp +++ b/tests/library/sub-id-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file sub-id-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/symbol-hashtable-test.cpp b/tests/library/symbol-hashtable-test.cpp index 00473540f..247a87f59 100644 --- a/tests/library/symbol-hashtable-test.cpp +++ b/tests/library/symbol-hashtable-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file symbol-hashtable-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/symbol-test.cpp b/tests/library/symbol-test.cpp index de8ccbb1d..5d1023c22 100644 --- a/tests/library/symbol-test.cpp +++ b/tests/library/symbol-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file symbol-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/test/test-event-log-test.cpp b/tests/library/test/test-event-log-test.cpp index 60e7c5f4c..287f8515d 100644 --- a/tests/library/test/test-event-log-test.cpp +++ b/tests/library/test/test-event-log-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file test-event-log-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/test/test-helper-test.cpp b/tests/library/test/test-helper-test.cpp index 8028364d0..d46a6be77 100644 --- a/tests/library/test/test-helper-test.cpp +++ b/tests/library/test/test-helper-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file test-helper-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/test/test-helper-variadic-test.cpp b/tests/library/test/test-helper-variadic-test.cpp index 0cdf0a2fa..e8c9d129b 100644 --- a/tests/library/test/test-helper-variadic-test.cpp +++ b/tests/library/test/test-helper-variadic-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file test-helper-variadic-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/test/test-option-test.cpp b/tests/library/test/test-option-test.cpp index 01709fbaa..2283020c6 100644 --- a/tests/library/test/test-option-test.cpp +++ b/tests/library/test/test-option-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file test-option-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/typed-allocation-manager-test.cpp b/tests/library/typed-allocation-manager-test.cpp index 128d7da77..bee4fed72 100644 --- a/tests/library/typed-allocation-manager-test.cpp +++ b/tests/library/typed-allocation-manager-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file typed-allocation-manager-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/unique-malloc-owner-test.cpp b/tests/library/unique-malloc-owner-test.cpp index a75358dd3..e558f28aa 100644 --- a/tests/library/unique-malloc-owner-test.cpp +++ b/tests/library/unique-malloc-owner-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file unique-malloc-owner-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/util-collection-test.cpp b/tests/library/util-collection-test.cpp index faaa4c925..176ffb045 100644 --- a/tests/library/util-collection-test.cpp +++ b/tests/library/util-collection-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file util-collection-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/util-floordiv-test.cpp b/tests/library/util-floordiv-test.cpp index dac4c65bc..cc8035463 100644 --- a/tests/library/util-floordiv-test.cpp +++ b/tests/library/util-floordiv-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file util-floordiv-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/util-floorwrap-test.cpp b/tests/library/util-floorwrap-test.cpp index bf49fabd7..c859dcdc8 100644 --- a/tests/library/util-floorwrap-test.cpp +++ b/tests/library/util-floorwrap-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file util-floorwrap-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/util-foreach-test.cpp b/tests/library/util-foreach-test.cpp index 7ee572813..e2dbfa276 100644 --- a/tests/library/util-foreach-test.cpp +++ b/tests/library/util-foreach-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file util-foreach-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/variant-test.cpp b/tests/library/variant-test.cpp index a231bdb80..12a180652 100644 --- a/tests/library/variant-test.cpp +++ b/tests/library/variant-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file variant-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/vector-transfer-test.cpp b/tests/library/vector-transfer-test.cpp index 8f0004ec1..e9d33d5ce 100644 --- a/tests/library/vector-transfer-test.cpp +++ b/tests/library/vector-transfer-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file vector-transfer-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/library/verb-function-dispatch-test.cpp b/tests/library/verb-function-dispatch-test.cpp index ae23446fd..6dcc3eead 100644 --- a/tests/library/verb-function-dispatch-test.cpp +++ b/tests/library/verb-function-dispatch-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file verb-function-dispatch-test.cpp + ** unit test §§TODO§§ */ diff --git a/tests/operation/bugs/hello-bug-test.cpp b/tests/operation/bugs/hello-bug-test.cpp index 84ec29cd7..325462893 100644 --- a/tests/operation/bugs/hello-bug-test.cpp +++ b/tests/operation/bugs/hello-bug-test.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file hello-bug-test.cpp + ** unit test §§TODO§§ */ From 42d97f6cf6ac4263b5b4d7cf60e086125aaa8c02 Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Wed, 22 Feb 2017 01:58:49 +0100 Subject: [PATCH 24/26] Doxygen: supply missing file level comments for test support helpers --- tests/core/backend/media-access-mock.hpp | 8 ++++++-- tests/core/proc/asset/testasset.cpp | 4 ++-- tests/core/proc/asset/testasset.hpp | 4 ++-- tests/core/proc/asset/testclipasset.hpp | 4 ++-- tests/core/proc/engine/testframe.cpp | 4 ++-- tests/core/proc/engine/testframe.hpp | 4 ++-- .../mobject/session/test-scope-invalid.hpp | 5 +++-- .../core/proc/mobject/session/test-scopes.cpp | 6 ++++-- .../core/proc/mobject/session/test-scopes.hpp | 7 +++++-- tests/core/proc/mobject/session/testclip.cpp | 4 ++-- tests/core/proc/mobject/session/testclip.hpp | 4 ++-- tests/core/proc/mobject/session/testroot.hpp | 6 ++++-- .../core/proc/mobject/session/testsession1.hpp | 7 +++++-- .../interface/{say_hello.h => say-hello.h} | 18 +++++++++--------- tests/library/test-target-obj.hpp | 6 ++++-- .../{example_plugin.c => example-plugin.c} | 11 +++++++---- .../{example_plugin.cpp => example-plugin.cpp} | 9 ++++++--- tests/testrunner.cpp | 7 +++++-- tests/tool/vgsuppression.c | 9 +++++++-- 19 files changed, 79 insertions(+), 48 deletions(-) rename tests/include/interface/{say_hello.h => say-hello.h} (56%) rename tests/plugin/test-c-plugin/{example_plugin.c => example-plugin.c} (96%) rename tests/plugin/test-cpp-plugin/{example_plugin.cpp => example-plugin.cpp} (93%) diff --git a/tests/core/backend/media-access-mock.hpp b/tests/core/backend/media-access-mock.hpp index 17c3ed267..f44e9060e 100644 --- a/tests/core/backend/media-access-mock.hpp +++ b/tests/core/backend/media-access-mock.hpp @@ -20,8 +20,12 @@ */ -/** @file §§§ - ** unit test TODO §§§ +/** @file media-access-mock.hpp + ** Unit test helper to access an emulated media file. + ** This can be used to inject specific metadata or media properties, + ** or even to feed generated media content into the code to be tested. + ** + ** @todo this facility was occasionally used until 2011, yet never really completed */ diff --git a/tests/core/proc/asset/testasset.cpp b/tests/core/proc/asset/testasset.cpp index 3342d5e74..57ef73c30 100644 --- a/tests/core/proc/asset/testasset.cpp +++ b/tests/core/proc/asset/testasset.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file testasset.cpp + ** Implementation of a mocked Asset for unit tests */ diff --git a/tests/core/proc/asset/testasset.hpp b/tests/core/proc/asset/testasset.hpp index 689b1262e..12d4b494f 100644 --- a/tests/core/proc/asset/testasset.hpp +++ b/tests/core/proc/asset/testasset.hpp @@ -20,8 +20,8 @@ */ -/** @file §§§ - ** unit test TODO §§§ +/** @file testasset.hpp + ** A mock asset to support unit testing */ diff --git a/tests/core/proc/asset/testclipasset.hpp b/tests/core/proc/asset/testclipasset.hpp index e31616f8d..b10925925 100644 --- a/tests/core/proc/asset/testclipasset.hpp +++ b/tests/core/proc/asset/testclipasset.hpp @@ -20,8 +20,8 @@ */ -/** @file §§§ - ** unit test TODO §§§ +/** @file testclipasset.hpp + ** A placeholder Clip asset to support unit testing */ diff --git a/tests/core/proc/engine/testframe.cpp b/tests/core/proc/engine/testframe.cpp index 3b58924a6..1682fdb4e 100644 --- a/tests/core/proc/engine/testframe.cpp +++ b/tests/core/proc/engine/testframe.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file testframe.cpp + ** Implementation of fake data frames to support unit testing */ diff --git a/tests/core/proc/engine/testframe.hpp b/tests/core/proc/engine/testframe.hpp index a124f4e1b..e39be683e 100644 --- a/tests/core/proc/engine/testframe.hpp +++ b/tests/core/proc/engine/testframe.hpp @@ -20,8 +20,8 @@ */ -/** @file §§§ - ** unit test TODO §§§ +/** @file testframe.hpp + ** Unit test helper to generate fake test data frames */ diff --git a/tests/core/proc/mobject/session/test-scope-invalid.hpp b/tests/core/proc/mobject/session/test-scope-invalid.hpp index 24c302658..b0a1849f6 100644 --- a/tests/core/proc/mobject/session/test-scope-invalid.hpp +++ b/tests/core/proc/mobject/session/test-scope-invalid.hpp @@ -20,8 +20,9 @@ */ -/** @file §§§ - ** unit test TODO §§§ +/** @file test-scope-invalid.hpp + ** Unit test helper to generate deliberately wrong placement scopes. + ** Usable to cover error handling related to QueryFocus and ScopePath */ diff --git a/tests/core/proc/mobject/session/test-scopes.cpp b/tests/core/proc/mobject/session/test-scopes.cpp index 5e86d4397..b7374d926 100644 --- a/tests/core/proc/mobject/session/test-scopes.cpp +++ b/tests/core/proc/mobject/session/test-scopes.cpp @@ -20,8 +20,10 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file test-scopes.cpp + ** Implementation of nested test scopes to cover the placement index. + ** This translation unit builds mock "session content" with a fixed, known layout, + ** which can be used to verify the behaviour of session query and content discovery */ diff --git a/tests/core/proc/mobject/session/test-scopes.hpp b/tests/core/proc/mobject/session/test-scopes.hpp index 1702a30e1..eb9d49d77 100644 --- a/tests/core/proc/mobject/session/test-scopes.hpp +++ b/tests/core/proc/mobject/session/test-scopes.hpp @@ -20,8 +20,11 @@ */ -/** @file §§§ - ** unit test TODO §§§ +/** @file test-scopes.hpp + ** Unit test helper to generate a system of nested test scopes. + ** These can be used to verify session search and discovery functionality. + ** The build_testScopes() function generates a system of placements and MObjects + ** with a known, fixed layout. */ diff --git a/tests/core/proc/mobject/session/testclip.cpp b/tests/core/proc/mobject/session/testclip.cpp index b275f7753..9edd7df3f 100644 --- a/tests/core/proc/mobject/session/testclip.cpp +++ b/tests/core/proc/mobject/session/testclip.cpp @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file testclip.cpp + ** Implementation of a stubbed clip object to support unit testing */ diff --git a/tests/core/proc/mobject/session/testclip.hpp b/tests/core/proc/mobject/session/testclip.hpp index 5a6d327f9..dcd3adef1 100644 --- a/tests/core/proc/mobject/session/testclip.hpp +++ b/tests/core/proc/mobject/session/testclip.hpp @@ -20,8 +20,8 @@ */ -/** @file §§§ - ** unit test TODO §§§ +/** @file testclip.hpp + ** A stub implementation of the Clip interface for unit testing */ diff --git a/tests/core/proc/mobject/session/testroot.hpp b/tests/core/proc/mobject/session/testroot.hpp index 8c1474675..93d539d3b 100644 --- a/tests/core/proc/mobject/session/testroot.hpp +++ b/tests/core/proc/mobject/session/testroot.hpp @@ -20,8 +20,10 @@ */ -/** @file §§§ - ** unit test TODO §§§ +/** @file testroot.hpp + ** Setup of a faked session root for unit testing. + ** This works together with some likewise manipulated mock rules to build content + ** with known layout to be scrutinised in test */ diff --git a/tests/core/proc/mobject/session/testsession1.hpp b/tests/core/proc/mobject/session/testsession1.hpp index 3e0f1fcf2..1d47c7ea7 100644 --- a/tests/core/proc/mobject/session/testsession1.hpp +++ b/tests/core/proc/mobject/session/testsession1.hpp @@ -20,8 +20,11 @@ */ -/** @file §§§ - ** unit test TODO §§§ +/** @file testsession1.hpp + ** Dummy session content prepared for unit test + ** @todo this is an idea from the early stages of the project and was never really implemented. + ** But it still seems like a good idea (as of 2016), while likely the implementation will be + ** completely different, based on JSON to be injected via the diff system */ diff --git a/tests/include/interface/say_hello.h b/tests/include/interface/say-hello.h similarity index 56% rename from tests/include/interface/say_hello.h rename to tests/include/interface/say-hello.h index d9696e57b..d94acd8ad 100644 --- a/tests/include/interface/say_hello.h +++ b/tests/include/interface/say-hello.h @@ -1,20 +1,20 @@ +/** @file say-hello.h + ** A mock interface to support testing of the interface system + */ + +#ifndef TEST_INCLUDE_SAY_HELLO_H +#define TEST_INCLUDE_SAY_HELLO_H + #include "common/interface.h" -/* - one interface which can greet in different languages -*/ +/** mock interface which can greet in different languages */ -/** @file §§§ - ** unit test TODO §§§ - */ LUMIERA_INTERFACE_DECLARE (lumieraorg_testhello, 0, LUMIERA_INTERFACE_SLOT (void, hello, (void)), LUMIERA_INTERFACE_SLOT (void, goodbye, (const char*)), ); -/* - and now one which will be used to test if interfaces can open and call each other -*/ +/** mock interface to test opening and closing of dependent interfaces */ LUMIERA_INTERFACE_DECLARE (lumieraorg_testtest, 0, LUMIERA_INTERFACE_SLOT (void, testit, (void)), ); diff --git a/tests/library/test-target-obj.hpp b/tests/library/test-target-obj.hpp index 2e5412fb8..d09b5a598 100644 --- a/tests/library/test-target-obj.hpp +++ b/tests/library/test-target-obj.hpp @@ -20,8 +20,10 @@ */ -/** @file §§§ - ** unit test TODO §§§ +/** @file test-target-obj.hpp + ** Dummy target object to be created by factory for unit tests + ** Used to verify sane memory management and instance lifecycle for such + ** objects generated as singleton or by factory */ diff --git a/tests/plugin/test-c-plugin/example_plugin.c b/tests/plugin/test-c-plugin/example-plugin.c similarity index 96% rename from tests/plugin/test-c-plugin/example_plugin.c rename to tests/plugin/test-c-plugin/example-plugin.c index d67c80156..438f75f50 100644 --- a/tests/plugin/test-c-plugin/example_plugin.c +++ b/tests/plugin/test-c-plugin/example-plugin.c @@ -1,5 +1,5 @@ /* - example_plugin - example plugin for testing the interface/plugin system + ExamplePlugin - example plugin for testing the interface/plugin system Copyright (C) Lumiera.org 2008, Christian Thaeter @@ -20,8 +20,11 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file example-plugin.c + ** Dummy C plug-in to cover the plugin loader for unit test + ** This file defines a Lumiera plug-in written in plain C, + ** implementing the `lumieraorg_testhello` interface + ** @see test-interfaces.c */ @@ -30,7 +33,7 @@ #include "common/interface-descriptor.h" #include "common/config-interface.h" -#include "interface/say_hello.h" +#include "interface/say-hello.h" LUMIERA_PLUGIN_INTERFACEHANDLE; diff --git a/tests/plugin/test-cpp-plugin/example_plugin.cpp b/tests/plugin/test-cpp-plugin/example-plugin.cpp similarity index 93% rename from tests/plugin/test-cpp-plugin/example_plugin.cpp rename to tests/plugin/test-cpp-plugin/example-plugin.cpp index 552a26c2f..62e88fa34 100644 --- a/tests/plugin/test-cpp-plugin/example_plugin.cpp +++ b/tests/plugin/test-cpp-plugin/example-plugin.cpp @@ -21,8 +21,11 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file example-plugin.cpp + ** Dummy C++ plug-in to cover the plugin loader for unit test + ** This file defines a Lumiera plug-in written in C++, + ** implementing the `lumieraorg_testhello` interface + ** @see test-interfaces.c */ @@ -35,7 +38,7 @@ extern "C" { #include "common/interface.h" #include "common/interface-descriptor.h" -#include "interface/say_hello.h" +#include "interface/say-hello.h" } #include diff --git a/tests/testrunner.cpp b/tests/testrunner.cpp index 8c9c91d24..475dd3c0d 100644 --- a/tests/testrunner.cpp +++ b/tests/testrunner.cpp @@ -21,8 +21,11 @@ * *****************************************************/ -/** @file §§§ - ** unit test TODO §§§ +/** @file testrunner.cpp + ** Lumiera unit test suite + ** A simple test runner application. + ** The build system will link the individual shared libraries with the test code + ** together with this translation unit into the executable `target/test-suite` */ #include "include/lifecycle.h" diff --git a/tests/tool/vgsuppression.c b/tests/tool/vgsuppression.c index 82f7ff474..846d034b1 100644 --- a/tests/tool/vgsuppression.c +++ b/tests/tool/vgsuppression.c @@ -19,8 +19,13 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ -/** @file §§§ - ** unit test TODO §§§ +/** @file vgsuppression.c + ** dummy executable to generate _valgrind suppressions_. + ** When running code under `valgrind` to detect memory leaks, typically a well known set + ** of false alarms will be reported. The reason is that some facilities, either implemented + ** by our own or from third party libraries, just choose never to free some working buffers. + ** To deal with this well known issue, `valgrind` allows to be "primed" with a specifically + ** crafted executable, which deliberately triggers just these false memory leak alarms. */ /* From 155bf95ce5f773a73da7f3721545ba7df49f34db Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Wed, 22 Feb 2017 03:17:18 +0100 Subject: [PATCH 25/26] Doxygen: magically insert a reference to the test class MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit this bit of Sed magic relies on the fact that we happen to write the almost correct class name of a test into the header comment. HOWTO: for F in $(find tests -type f \( -name '*.cpp' \) -exec egrep -q '§§TODO§§' {} \; -print); do sed -r -i -e' 2 {h;x;s/\s+(.+)\(Test\).*$/\\ref \1_test/;x}; /§§TODO§§/ {s/§§TODO§§//;G;s/\n//}' $F; done --- tests/backend/sync-classlock-test.cpp | 2 +- tests/backend/sync-locking-test.cpp | 2 +- tests/backend/sync-timedwait-test.cpp | 2 +- tests/backend/sync-waiting-test.cpp | 2 +- tests/backend/thread-local-test.cpp | 2 +- tests/backend/thread-wrapper-join-test.cpp | 2 +- tests/backend/thread-wrapper-test.cpp | 2 +- tests/basics/diagnostic-context-test.cpp | 2 +- ...cstest.cpp => stream-type-basics-test.cpp} | 2 +- ...est.cpp => stream-type-lifecycle-test.cpp} | 2 +- .../time/digxel-configurations-test.cpp | 2 +- tests/basics/time/digxel-test.cpp | 2 +- tests/basics/time/format-support-test.cpp | 2 +- tests/basics/time/quantiser-basics-test.cpp | 2 +- tests/basics/time/time-basics-test.cpp | 4 ++-- tests/basics/time/time-control-test.cpp | 2 +- tests/basics/time/time-formats-test.cpp | 2 +- tests/basics/time/time-mutation-test.cpp | 2 +- tests/basics/time/time-parsing-test.cpp | 2 +- tests/basics/time/time-quantisation-test.cpp | 2 +- tests/basics/time/time-value-test.cpp | 2 +- tests/basics/visitingtool-extended-test.cpp | 2 +- tests/basics/visitingtool-test.cpp | 2 +- .../application/subsystem-runner-test.cpp | 2 +- tests/core/backend/engine/dummy-job.cpp | 2 +- tests/core/backend/engine/job-hash-test.cpp | 2 +- .../engine/scheduler-interface-test.cpp | 2 +- tests/core/backend/media-access-mock-test.cpp | 2 +- tests/core/proc/asset/asset-category-test.cpp | 2 +- tests/core/proc/asset/basicpipetest.cpp | 2 +- tests/core/proc/asset/compoundmediatest.cpp | 2 +- tests/core/proc/asset/create-asset-test.cpp | 2 +- tests/core/proc/asset/deleteassettest.cpp | 2 +- .../core/proc/asset/dependent-assets-test.cpp | 2 +- tests/core/proc/asset/entry-id-test.cpp | 2 +- ...tstest.cpp => identity-of-assets-test.cpp} | 2 +- .../{makecliptest.cpp => make-clip-test.cpp} | 2 +- ...est.cpp => media-structure-query-test.cpp} | 4 ++-- .../proc/asset/meta/time-grid-basics-test.cpp | 2 +- ...tstest.cpp => ordering-of-assets-test.cpp} | 2 +- tests/core/proc/asset/typed-id-test.cpp | 2 +- .../control/argument-tuple-accept-test.cpp | 2 +- .../proc/control/command-argument-test.cpp | 2 +- .../core/proc/control/command-basic-test.cpp | 2 +- .../proc/control/command-binding-test.cpp | 2 +- .../control/command-clone-builder-test.cpp | 2 +- .../proc/control/command-equality-test.cpp | 2 +- .../control/command-message-binding-test.cpp | 2 +- .../proc/control/command-mutation-test.cpp | 2 +- .../proc/control/command-registry-test.cpp | 2 +- tests/core/proc/control/command-use1-test.cpp | 2 +- tests/core/proc/control/command-use2-test.cpp | 2 +- tests/core/proc/control/command-use3-test.cpp | 2 +- .../control/handling-pattern-basics-test.cpp | 2 +- .../handling-pattern-standard-impl-test.cpp | 2 +- tests/core/proc/control/memento-tie-test.cpp | 2 +- .../core/proc/control/test-dummy-commands.cpp | 2 +- tests/core/proc/engine/buff-table-test.cpp | 2 +- .../proc/engine/buffer-metadata-key-test.cpp | 2 +- .../core/proc/engine/buffer-metadata-test.cpp | 2 +- .../engine/buffer-provider-protocol-test.cpp | 2 +- tests/core/proc/engine/calc-stream-test.cpp | 2 +- .../proc/engine/dispatcher-interface-test.cpp | 2 +- .../proc/engine/engine-interface-test.cpp | 2 +- tests/core/proc/engine/node-basic-test.cpp | 2 +- .../proc/engine/node-fabrication-test.cpp | 2 +- .../core/proc/engine/node-operation-test.cpp | 2 +- tests/core/proc/engine/node-source-test.cpp | 2 +- tests/core/proc/engine/testframe-test.cpp | 2 +- .../tracking-heap-block-provider-test.cpp | 4 ++-- ...segmenttest.cpp => build-segment-test.cpp} | 2 +- ...ldertooltest.cpp => builder-tool-test.cpp} | 2 +- .../builder/fixture-change-detector-test.cpp | 5 ++-- .../builder/model-port-registry-test.cpp | 2 +- .../segmentation-datastructure-test.cpp | 2 +- ...egmenttest.cpp => render-segment-test.cpp} | 2 +- .../proc/mobject/mobject-interface-test.cpp | 2 +- tests/core/proc/mobject/mobject-ref-test.cpp | 2 +- .../core/proc/mobject/output-mapping-test.cpp | 2 +- .../proc/mobject/placement-basic-test.cpp | 2 +- .../proc/mobject/placement-hierarchy-test.cpp | 2 +- .../placement-object-identity-test.cpp | 2 +- .../core/proc/mobject/placement-ref-test.cpp | 2 +- .../{addcliptest.cpp => add-clip-test.cpp} | 2 +- .../session/defs-manager-impl-test.cpp | 2 +- .../mobject/session/defs-manager-test.cpp | 2 +- .../session/defs-registry-impl-test.cpp | 2 +- .../proc/mobject/session/deletecliptest.cpp | 2 +- .../session/placement-index-query-test.cpp | 2 +- .../mobject/session/placement-index-test.cpp | 2 +- .../mobject/session/placement-scope-test.cpp | 2 +- .../session/query-focus-stack-test.cpp | 2 +- .../proc/mobject/session/query-focus-test.cpp | 2 +- .../mobject/session/query-resolver-test.cpp | 2 +- .../mobject/session/rebuildfixturetest.cpp | 2 +- .../proc/mobject/session/scope-path-test.cpp | 2 +- .../proc/mobject/session/scope-query-test.cpp | 2 +- .../session/session-element-query-test.cpp | 2 +- .../session/session-element-tracker-test.cpp | 2 +- ...nagertest.cpp => session-manager-test.cpp} | 2 +- .../session/session-modify-parts-test.cpp | 2 +- .../session/session-service-access-test.cpp | 2 +- .../session/session-structure-test.cpp | 2 +- .../timeline-sequence-handling-test.cpp | 2 +- .../proc/play/dummy-play-connection-test.cpp | 2 +- .../proc/play/output-slot-protocol-test.cpp | 2 +- .../proc/play/timing-constraints-test.cpp | 2 +- tests/gui/bus-term-test.cpp | 2 +- .../state-map-grouping-storage-test.cpp | 2 +- tests/gui/test-gui-test.cpp | 23 ++++++++----------- tests/library/advice/advice-basics-test.cpp | 2 +- .../advice/advice-binding-pattern-test.cpp | 2 +- .../advice/advice-configuration-test.cpp | 2 +- tests/library/advice/advice-index-test.cpp | 2 +- .../advice/advice-multiplicity-test.cpp | 2 +- .../library/advice/advice-situations-test.cpp | 2 +- tests/library/allocation-cluster-test.cpp | 2 +- tests/library/app-config-test.cpp | 2 +- tests/library/bool-checkable-test.cpp | 2 +- tests/library/cmdline-wrapper-test.cpp | 2 +- tests/library/custom-shared-ptr-test.cpp | 2 +- tests/library/del-stash-test.cpp | 2 +- tests/library/dependency-factory-test.cpp | 2 +- .../diff/diff-complex-application-test.cpp | 4 ++-- tests/library/diff/diff-index-table-test.cpp | 2 +- .../diff/diff-list-application-test.cpp | 2 +- .../diff/diff-list-generation-test.cpp | 2 +- .../diff/diff-tree-application-test.cpp | 2 +- tests/library/diff/gen-node-basic-test.cpp | 2 +- .../generic-record-representation-test.cpp | 2 +- .../diff/tree-mutator-binding-test.cpp | 2 +- tests/library/diff/tree-mutator-test.cpp | 2 +- ...errortest.cpp => exception-error-test.cpp} | 2 +- tests/library/format-cout-test.cpp | 2 +- tests/library/format-helper-test.cpp | 2 +- tests/library/format-string-test.cpp | 2 +- tests/library/functor-util-test.cpp | 2 +- tests/library/hash-generator-test.cpp | 2 +- tests/library/hash-indexed-test.cpp | 2 +- .../hash-standard-to-boost-bridge-test.cpp | 2 +- tests/library/helloworldtest.cpp | 2 +- .../hierarchy-orientation-indicator-test.cpp | 2 +- .../library/idi/generic-id-function-test.cpp | 2 +- tests/library/item-wrapper-test.cpp | 2 +- tests/library/iter-adapter-stl-test.cpp | 2 +- tests/library/iter-adapter-test.cpp | 2 +- tests/library/iter-cursor-test.cpp | 2 +- tests/library/iter-explorer-test.cpp | 2 +- tests/library/iter-queue-test.cpp | 2 +- tests/library/iter-source-test.cpp | 2 +- tests/library/iter-stack-test.cpp | 2 +- tests/library/itertools-test.cpp | 2 +- ...{lifecycletest.cpp => life-cycle-test.cpp} | 2 +- tests/library/linked-elements-test.cpp | 2 +- tests/library/maybe-value-test.cpp | 2 +- tests/library/meta/access-casted-test.cpp | 2 +- tests/library/meta/duck-detector-test.cpp | 2 +- .../meta/function-composition-test.cpp | 2 +- tests/library/meta/function-erasure-test.cpp | 2 +- .../meta/generator-combinations-test.cpp | 2 +- .../meta/iterable-classification-test.cpp | 2 +- tests/library/meta/meta-utils-test.cpp | 2 +- tests/library/meta/tuple-record-init-test.cpp | 2 +- tests/library/meta/type-demangling-test.cpp | 2 +- tests/library/meta/type-display-test.cpp | 2 +- tests/library/meta/typelist-test.cpp | 2 +- tests/library/meta/typelist-util-test.cpp | 2 +- .../meta/virtual-copy-support-test.cpp | 2 +- tests/library/multifact-argument-test.cpp | 2 +- tests/library/multifact-singleton-test.cpp | 2 +- tests/library/multifact-test.cpp | 2 +- tests/library/null-value-test.cpp | 2 +- tests/library/opaque-holder-test.cpp | 2 +- .../library/opaque-unchecked-buffer-test.cpp | 2 +- tests/library/optional-ref-test.cpp | 2 +- tests/library/polymorphic-value-test.cpp | 2 +- tests/library/query-text-test.cpp | 2 +- tests/library/query/query-utils-test.cpp | 2 +- tests/library/ref-array-test.cpp | 2 +- tests/library/removefromsettest.cpp | 2 +- tests/library/sanitised-identifier-test.cpp | 2 +- tests/library/scoped-collection-test.cpp | 2 +- tests/library/scoped-holder-test.cpp | 2 +- tests/library/scoped-holder-transfer-test.cpp | 2 +- tests/library/scoped-ptrvect-test.cpp | 2 +- tests/library/search-path-splitter-test.cpp | 2 +- tests/library/simple-allocator-test.cpp | 2 +- tests/library/singleton-subclass-test.cpp | 2 +- tests/library/singleton-test.cpp | 2 +- tests/library/singleton-testmock-test.cpp | 2 +- tests/library/sub-id-test.cpp | 2 +- tests/library/symbol-hashtable-test.cpp | 2 +- tests/library/symbol-test.cpp | 2 +- tests/library/test/test-event-log-test.cpp | 2 +- tests/library/test/test-helper-test.cpp | 2 +- .../test/test-helper-variadic-test.cpp | 2 +- tests/library/test/test-option-test.cpp | 2 +- .../library/typed-allocation-manager-test.cpp | 2 +- tests/library/unique-malloc-owner-test.cpp | 2 +- tests/library/util-collection-test.cpp | 2 +- tests/library/util-floordiv-test.cpp | 2 +- tests/library/util-floorwrap-test.cpp | 2 +- tests/library/util-foreach-test.cpp | 2 +- tests/library/variant-test.cpp | 2 +- tests/library/vector-transfer-test.cpp | 2 +- tests/library/verb-function-dispatch-test.cpp | 2 +- tests/operation/bugs/hello-bug-test.cpp | 4 ++-- 207 files changed, 222 insertions(+), 226 deletions(-) rename tests/basics/{streamtypebasicstest.cpp => stream-type-basics-test.cpp} (98%) rename tests/basics/{streamtypelifecycletest.cpp => stream-type-lifecycle-test.cpp} (98%) rename tests/core/proc/asset/{identityofassetstest.cpp => identity-of-assets-test.cpp} (98%) rename tests/core/proc/asset/{makecliptest.cpp => make-clip-test.cpp} (98%) rename tests/core/proc/asset/{mediastructurequerytest.cpp => media-structure-query-test.cpp} (93%) rename tests/core/proc/asset/{orderingofassetstest.cpp => ordering-of-assets-test.cpp} (99%) rename tests/core/proc/mobject/builder/{buildsegmenttest.cpp => build-segment-test.cpp} (97%) rename tests/core/proc/mobject/builder/{buildertooltest.cpp => builder-tool-test.cpp} (99%) rename tests/core/proc/mobject/controller/{rendersegmenttest.cpp => render-segment-test.cpp} (98%) rename tests/core/proc/mobject/session/{addcliptest.cpp => add-clip-test.cpp} (98%) rename tests/core/proc/mobject/session/{sessionmanagertest.cpp => session-manager-test.cpp} (99%) rename tests/library/{exceptionerrortest.cpp => exception-error-test.cpp} (99%) rename tests/library/{lifecycletest.cpp => life-cycle-test.cpp} (98%) diff --git a/tests/backend/sync-classlock-test.cpp b/tests/backend/sync-classlock-test.cpp index 94c6b7518..f8389dd22 100644 --- a/tests/backend/sync-classlock-test.cpp +++ b/tests/backend/sync-classlock-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file sync-classlock-test.cpp - ** unit test §§TODO§§ + ** unit test \ref SyncClasslock_test */ diff --git a/tests/backend/sync-locking-test.cpp b/tests/backend/sync-locking-test.cpp index 43166cdd3..2bf1aea69 100644 --- a/tests/backend/sync-locking-test.cpp +++ b/tests/backend/sync-locking-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file sync-locking-test.cpp - ** unit test §§TODO§§ + ** unit test \ref SyncLocking_test */ diff --git a/tests/backend/sync-timedwait-test.cpp b/tests/backend/sync-timedwait-test.cpp index b06ba52dd..3f7e5d31d 100644 --- a/tests/backend/sync-timedwait-test.cpp +++ b/tests/backend/sync-timedwait-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file sync-timedwait-test.cpp - ** unit test §§TODO§§ + ** unit test \ref SyncTimedwait_test */ diff --git a/tests/backend/sync-waiting-test.cpp b/tests/backend/sync-waiting-test.cpp index f88333df9..8533c3c28 100644 --- a/tests/backend/sync-waiting-test.cpp +++ b/tests/backend/sync-waiting-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file sync-waiting-test.cpp - ** unit test §§TODO§§ + ** unit test \ref SyncWaiting_test */ diff --git a/tests/backend/thread-local-test.cpp b/tests/backend/thread-local-test.cpp index e102423d9..78ff14bc6 100644 --- a/tests/backend/thread-local-test.cpp +++ b/tests/backend/thread-local-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file thread-local-test.cpp - ** unit test §§TODO§§ + ** unit test \ref ThreadLocal_test */ diff --git a/tests/backend/thread-wrapper-join-test.cpp b/tests/backend/thread-wrapper-join-test.cpp index ae0fd7bbd..b9c421a42 100644 --- a/tests/backend/thread-wrapper-join-test.cpp +++ b/tests/backend/thread-wrapper-join-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file thread-wrapper-join-test.cpp - ** unit test §§TODO§§ + ** unit test \ref ThreadWrapperJoin_test */ diff --git a/tests/backend/thread-wrapper-test.cpp b/tests/backend/thread-wrapper-test.cpp index 2d38c9493..55b165d47 100644 --- a/tests/backend/thread-wrapper-test.cpp +++ b/tests/backend/thread-wrapper-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file thread-wrapper-test.cpp - ** unit test §§TODO§§ + ** unit test \ref ThreadWrapper_test */ diff --git a/tests/basics/diagnostic-context-test.cpp b/tests/basics/diagnostic-context-test.cpp index c050d5742..723ad2589 100644 --- a/tests/basics/diagnostic-context-test.cpp +++ b/tests/basics/diagnostic-context-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file diagnostic-context-test.cpp - ** unit test §§TODO§§ + ** unit test \ref DiagnosticContext_test */ diff --git a/tests/basics/streamtypebasicstest.cpp b/tests/basics/stream-type-basics-test.cpp similarity index 98% rename from tests/basics/streamtypebasicstest.cpp rename to tests/basics/stream-type-basics-test.cpp index cc3170cbe..5b295c516 100644 --- a/tests/basics/streamtypebasicstest.cpp +++ b/tests/basics/stream-type-basics-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file streamtypebasicstest.cpp - ** unit test §§TODO§§ + ** unit test \ref StreamTypeBasics_test */ diff --git a/tests/basics/streamtypelifecycletest.cpp b/tests/basics/stream-type-lifecycle-test.cpp similarity index 98% rename from tests/basics/streamtypelifecycletest.cpp rename to tests/basics/stream-type-lifecycle-test.cpp index 43e1d4e4e..a27e0405e 100644 --- a/tests/basics/streamtypelifecycletest.cpp +++ b/tests/basics/stream-type-lifecycle-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file streamtypelifecycletest.cpp - ** unit test §§TODO§§ + ** unit test \ref StreamTypeLifecycle_test */ diff --git a/tests/basics/time/digxel-configurations-test.cpp b/tests/basics/time/digxel-configurations-test.cpp index 4a096ac37..635605e66 100644 --- a/tests/basics/time/digxel-configurations-test.cpp +++ b/tests/basics/time/digxel-configurations-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file digxel-configurations-test.cpp - ** unit test §§TODO§§ + ** unit test \ref DigxelConfigurations_test */ diff --git a/tests/basics/time/digxel-test.cpp b/tests/basics/time/digxel-test.cpp index 74ca56d6c..f8eb7efc5 100644 --- a/tests/basics/time/digxel-test.cpp +++ b/tests/basics/time/digxel-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file digxel-test.cpp - ** unit test §§TODO§§ + ** unit test \ref Digxel_test */ diff --git a/tests/basics/time/format-support-test.cpp b/tests/basics/time/format-support-test.cpp index 39361eca7..d2e57c729 100644 --- a/tests/basics/time/format-support-test.cpp +++ b/tests/basics/time/format-support-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file format-support-test.cpp - ** unit test §§TODO§§ + ** unit test \ref FormatSupport_test */ diff --git a/tests/basics/time/quantiser-basics-test.cpp b/tests/basics/time/quantiser-basics-test.cpp index 996f2c122..c93da9370 100644 --- a/tests/basics/time/quantiser-basics-test.cpp +++ b/tests/basics/time/quantiser-basics-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file quantiser-basics-test.cpp - ** unit test §§TODO§§ + ** unit test \ref QuantiserBasics_test */ diff --git a/tests/basics/time/time-basics-test.cpp b/tests/basics/time/time-basics-test.cpp index 3fb60b074..e8bf048b5 100644 --- a/tests/basics/time/time-basics-test.cpp +++ b/tests/basics/time/time-basics-test.cpp @@ -1,5 +1,5 @@ /* - LumiBasics(Test) - working with Lumiera's internal Time values + TimeBasics(Test) - working with Lumiera's internal Time values Copyright (C) Lumiera.org 2008, Hermann Vosseler @@ -21,7 +21,7 @@ * *****************************************************/ /** @file time-basics-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TimeBasics_test */ diff --git a/tests/basics/time/time-control-test.cpp b/tests/basics/time/time-control-test.cpp index 6e9e4f217..624c211d0 100644 --- a/tests/basics/time/time-control-test.cpp +++ b/tests/basics/time/time-control-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file time-control-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TimeControl_test */ diff --git a/tests/basics/time/time-formats-test.cpp b/tests/basics/time/time-formats-test.cpp index b54564e21..290e151cb 100644 --- a/tests/basics/time/time-formats-test.cpp +++ b/tests/basics/time/time-formats-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file time-formats-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TimeFormats_test */ diff --git a/tests/basics/time/time-mutation-test.cpp b/tests/basics/time/time-mutation-test.cpp index 7bf00c6ff..c0701c05f 100644 --- a/tests/basics/time/time-mutation-test.cpp +++ b/tests/basics/time/time-mutation-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file time-mutation-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TimeMutation_test */ diff --git a/tests/basics/time/time-parsing-test.cpp b/tests/basics/time/time-parsing-test.cpp index d077c648c..499b4efd5 100644 --- a/tests/basics/time/time-parsing-test.cpp +++ b/tests/basics/time/time-parsing-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file time-parsing-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TimeParsing_test */ diff --git a/tests/basics/time/time-quantisation-test.cpp b/tests/basics/time/time-quantisation-test.cpp index dc7d5ae1d..517b9bfc8 100644 --- a/tests/basics/time/time-quantisation-test.cpp +++ b/tests/basics/time/time-quantisation-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file time-quantisation-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TimeQuantisation_test */ diff --git a/tests/basics/time/time-value-test.cpp b/tests/basics/time/time-value-test.cpp index fdd6d817e..bf9b1a13e 100644 --- a/tests/basics/time/time-value-test.cpp +++ b/tests/basics/time/time-value-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file time-value-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TimeValue_test */ diff --git a/tests/basics/visitingtool-extended-test.cpp b/tests/basics/visitingtool-extended-test.cpp index e0550d26c..13d21bebd 100644 --- a/tests/basics/visitingtool-extended-test.cpp +++ b/tests/basics/visitingtool-extended-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file visitingtool-extended-test.cpp - ** unit test §§TODO§§ + ** unit test \ref VisitingToolExtended_test */ diff --git a/tests/basics/visitingtool-test.cpp b/tests/basics/visitingtool-test.cpp index 5c799ae74..9c6b7c655 100644 --- a/tests/basics/visitingtool-test.cpp +++ b/tests/basics/visitingtool-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file visitingtool-test.cpp - ** unit test §§TODO§§ + ** unit test \ref VisitingTool_test */ diff --git a/tests/core/application/subsystem-runner-test.cpp b/tests/core/application/subsystem-runner-test.cpp index cb565699b..5ce957eb0 100644 --- a/tests/core/application/subsystem-runner-test.cpp +++ b/tests/core/application/subsystem-runner-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file subsystem-runner-test.cpp - ** unit test §§TODO§§ + ** unit test \ref SubsystemRunner_test */ diff --git a/tests/core/backend/engine/dummy-job.cpp b/tests/core/backend/engine/dummy-job.cpp index 97aea2348..1b69ad09e 100644 --- a/tests/core/backend/engine/dummy-job.cpp +++ b/tests/core/backend/engine/dummy-job.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file dummy-job.cpp - ** unit test §§TODO§§ + ** Implementation of a dummy render job for unit tests */ diff --git a/tests/core/backend/engine/job-hash-test.cpp b/tests/core/backend/engine/job-hash-test.cpp index 02c0ed407..41f2fe21b 100644 --- a/tests/core/backend/engine/job-hash-test.cpp +++ b/tests/core/backend/engine/job-hash-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file job-hash-test.cpp - ** unit test §§TODO§§ + ** unit test \ref JobHash_test */ diff --git a/tests/core/backend/engine/scheduler-interface-test.cpp b/tests/core/backend/engine/scheduler-interface-test.cpp index cd16e19b5..adc03ea0f 100644 --- a/tests/core/backend/engine/scheduler-interface-test.cpp +++ b/tests/core/backend/engine/scheduler-interface-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file scheduler-interface-test.cpp - ** unit test §§TODO§§ + ** unit test \ref SchedulerInterface_test */ diff --git a/tests/core/backend/media-access-mock-test.cpp b/tests/core/backend/media-access-mock-test.cpp index 3c5eb06bb..6d4113bb8 100644 --- a/tests/core/backend/media-access-mock-test.cpp +++ b/tests/core/backend/media-access-mock-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file media-access-mock-test.cpp - ** unit test §§TODO§§ + ** unit test \ref MediaAccessMock_test */ diff --git a/tests/core/proc/asset/asset-category-test.cpp b/tests/core/proc/asset/asset-category-test.cpp index 5206e9d7e..b209eff6b 100644 --- a/tests/core/proc/asset/asset-category-test.cpp +++ b/tests/core/proc/asset/asset-category-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file asset-category-test.cpp - ** unit test §§TODO§§ + ** unit test \ref AssetCategory_test */ diff --git a/tests/core/proc/asset/basicpipetest.cpp b/tests/core/proc/asset/basicpipetest.cpp index 047ea64b0..476619c66 100644 --- a/tests/core/proc/asset/basicpipetest.cpp +++ b/tests/core/proc/asset/basicpipetest.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file basicpipetest.cpp - ** unit test §§TODO§§ + ** unit test \ref BasicPipe_test */ diff --git a/tests/core/proc/asset/compoundmediatest.cpp b/tests/core/proc/asset/compoundmediatest.cpp index c4f1d9936..b2f5a9cb7 100644 --- a/tests/core/proc/asset/compoundmediatest.cpp +++ b/tests/core/proc/asset/compoundmediatest.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file compoundmediatest.cpp - ** unit test §§TODO§§ + ** unit test \ref CompoundMedia_test */ diff --git a/tests/core/proc/asset/create-asset-test.cpp b/tests/core/proc/asset/create-asset-test.cpp index b9bd46bd4..100530366 100644 --- a/tests/core/proc/asset/create-asset-test.cpp +++ b/tests/core/proc/asset/create-asset-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file create-asset-test.cpp - ** unit test §§TODO§§ + ** unit test \ref CreateAsset_test */ diff --git a/tests/core/proc/asset/deleteassettest.cpp b/tests/core/proc/asset/deleteassettest.cpp index 75683baa7..6b3a3fb51 100644 --- a/tests/core/proc/asset/deleteassettest.cpp +++ b/tests/core/proc/asset/deleteassettest.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file deleteassettest.cpp - ** unit test §§TODO§§ + ** unit test \ref DeleteAsset_test */ diff --git a/tests/core/proc/asset/dependent-assets-test.cpp b/tests/core/proc/asset/dependent-assets-test.cpp index e79df7ea7..6d5eb8077 100644 --- a/tests/core/proc/asset/dependent-assets-test.cpp +++ b/tests/core/proc/asset/dependent-assets-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file dependent-assets-test.cpp - ** unit test §§TODO§§ + ** unit test \ref DependentAssets_test */ diff --git a/tests/core/proc/asset/entry-id-test.cpp b/tests/core/proc/asset/entry-id-test.cpp index 80cce133d..516253de8 100644 --- a/tests/core/proc/asset/entry-id-test.cpp +++ b/tests/core/proc/asset/entry-id-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file entry-id-test.cpp - ** unit test §§TODO§§ + ** unit test \ref EntryID_test */ diff --git a/tests/core/proc/asset/identityofassetstest.cpp b/tests/core/proc/asset/identity-of-assets-test.cpp similarity index 98% rename from tests/core/proc/asset/identityofassetstest.cpp rename to tests/core/proc/asset/identity-of-assets-test.cpp index 72af899a6..40e705e08 100644 --- a/tests/core/proc/asset/identityofassetstest.cpp +++ b/tests/core/proc/asset/identity-of-assets-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file identityofassetstest.cpp - ** unit test §§TODO§§ + ** unit test \ref IdentityOfAssets_test */ diff --git a/tests/core/proc/asset/makecliptest.cpp b/tests/core/proc/asset/make-clip-test.cpp similarity index 98% rename from tests/core/proc/asset/makecliptest.cpp rename to tests/core/proc/asset/make-clip-test.cpp index 93170b2db..070aa5ff0 100644 --- a/tests/core/proc/asset/makecliptest.cpp +++ b/tests/core/proc/asset/make-clip-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file makecliptest.cpp - ** unit test §§TODO§§ + ** unit test \ref MakeClip_test */ diff --git a/tests/core/proc/asset/mediastructurequerytest.cpp b/tests/core/proc/asset/media-structure-query-test.cpp similarity index 93% rename from tests/core/proc/asset/mediastructurequerytest.cpp rename to tests/core/proc/asset/media-structure-query-test.cpp index b5bb31f3e..9251be8fb 100644 --- a/tests/core/proc/asset/mediastructurequerytest.cpp +++ b/tests/core/proc/asset/media-structure-query-test.cpp @@ -1,5 +1,5 @@ /* - MediaStructureQuery(Test) - check functionallity used for creating media assets + MediaStructureQuery(Test) - check functionality used for creating media assets Copyright (C) Lumiera.org 2008, Hermann Vosseler @@ -21,7 +21,7 @@ * *****************************************************/ /** @file mediastructurequerytest.cpp - ** unit test §§TODO§§ + ** unit test \ref MediaStructureQuery_test */ diff --git a/tests/core/proc/asset/meta/time-grid-basics-test.cpp b/tests/core/proc/asset/meta/time-grid-basics-test.cpp index 055474f03..a5cae3e7c 100644 --- a/tests/core/proc/asset/meta/time-grid-basics-test.cpp +++ b/tests/core/proc/asset/meta/time-grid-basics-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file time-grid-basics-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TimeGridBasics_test */ diff --git a/tests/core/proc/asset/orderingofassetstest.cpp b/tests/core/proc/asset/ordering-of-assets-test.cpp similarity index 99% rename from tests/core/proc/asset/orderingofassetstest.cpp rename to tests/core/proc/asset/ordering-of-assets-test.cpp index 652d147ea..35ee89786 100644 --- a/tests/core/proc/asset/orderingofassetstest.cpp +++ b/tests/core/proc/asset/ordering-of-assets-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file orderingofassetstest.cpp - ** unit test §§TODO§§ + ** unit test \ref OrderingOfAssets_test */ diff --git a/tests/core/proc/asset/typed-id-test.cpp b/tests/core/proc/asset/typed-id-test.cpp index 93cc3049e..7fdc569f3 100644 --- a/tests/core/proc/asset/typed-id-test.cpp +++ b/tests/core/proc/asset/typed-id-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file typed-id-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TypedID_test */ diff --git a/tests/core/proc/control/argument-tuple-accept-test.cpp b/tests/core/proc/control/argument-tuple-accept-test.cpp index 59017628c..84db465ed 100644 --- a/tests/core/proc/control/argument-tuple-accept-test.cpp +++ b/tests/core/proc/control/argument-tuple-accept-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file argument-tuple-accept-test.cpp - ** unit test §§TODO§§ + ** unit test \ref ArgumentTupleAccept_test */ diff --git a/tests/core/proc/control/command-argument-test.cpp b/tests/core/proc/control/command-argument-test.cpp index cc7e81c0b..8d6b83f67 100644 --- a/tests/core/proc/control/command-argument-test.cpp +++ b/tests/core/proc/control/command-argument-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file command-argument-test.cpp - ** unit test §§TODO§§ + ** unit test \ref CommandArgument_test */ diff --git a/tests/core/proc/control/command-basic-test.cpp b/tests/core/proc/control/command-basic-test.cpp index e6523387f..4481d1b69 100644 --- a/tests/core/proc/control/command-basic-test.cpp +++ b/tests/core/proc/control/command-basic-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file command-basic-test.cpp - ** unit test §§TODO§§ + ** unit test \ref CommandBasic_test */ diff --git a/tests/core/proc/control/command-binding-test.cpp b/tests/core/proc/control/command-binding-test.cpp index 6f341050b..e224f7803 100644 --- a/tests/core/proc/control/command-binding-test.cpp +++ b/tests/core/proc/control/command-binding-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file command-binding-test.cpp - ** unit test §§TODO§§ + ** unit test \ref CommandBinding_test */ diff --git a/tests/core/proc/control/command-clone-builder-test.cpp b/tests/core/proc/control/command-clone-builder-test.cpp index 7d19baa50..86a881dea 100644 --- a/tests/core/proc/control/command-clone-builder-test.cpp +++ b/tests/core/proc/control/command-clone-builder-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file command-clone-builder-test.cpp - ** unit test §§TODO§§ + ** unit test \ref CommandCloneBuilder_test */ diff --git a/tests/core/proc/control/command-equality-test.cpp b/tests/core/proc/control/command-equality-test.cpp index a240950e1..1486806d3 100644 --- a/tests/core/proc/control/command-equality-test.cpp +++ b/tests/core/proc/control/command-equality-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file command-equality-test.cpp - ** unit test §§TODO§§ + ** unit test \ref CommandEquality_test */ diff --git a/tests/core/proc/control/command-message-binding-test.cpp b/tests/core/proc/control/command-message-binding-test.cpp index c073bd5ae..d29fe5c5d 100644 --- a/tests/core/proc/control/command-message-binding-test.cpp +++ b/tests/core/proc/control/command-message-binding-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file command-message-binding-test.cpp - ** unit test §§TODO§§ + ** unit test \ref CommandMessageBinding_test */ diff --git a/tests/core/proc/control/command-mutation-test.cpp b/tests/core/proc/control/command-mutation-test.cpp index 2c877f55c..3bf881ce0 100644 --- a/tests/core/proc/control/command-mutation-test.cpp +++ b/tests/core/proc/control/command-mutation-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file command-mutation-test.cpp - ** unit test §§TODO§§ + ** unit test \ref CommandMutation_test */ diff --git a/tests/core/proc/control/command-registry-test.cpp b/tests/core/proc/control/command-registry-test.cpp index bcfc2b98b..86da0febb 100644 --- a/tests/core/proc/control/command-registry-test.cpp +++ b/tests/core/proc/control/command-registry-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file command-registry-test.cpp - ** unit test §§TODO§§ + ** unit test \ref CommandRegistry_test */ diff --git a/tests/core/proc/control/command-use1-test.cpp b/tests/core/proc/control/command-use1-test.cpp index c035760d5..f288063dd 100644 --- a/tests/core/proc/control/command-use1-test.cpp +++ b/tests/core/proc/control/command-use1-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file command-use1-test.cpp - ** unit test §§TODO§§ + ** unit test \ref CommandUse1_test */ diff --git a/tests/core/proc/control/command-use2-test.cpp b/tests/core/proc/control/command-use2-test.cpp index d988242c3..bf393cf1d 100644 --- a/tests/core/proc/control/command-use2-test.cpp +++ b/tests/core/proc/control/command-use2-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file command-use2-test.cpp - ** unit test §§TODO§§ + ** unit test \ref CommandUse2_test */ diff --git a/tests/core/proc/control/command-use3-test.cpp b/tests/core/proc/control/command-use3-test.cpp index c31b5f988..e44c6bf20 100644 --- a/tests/core/proc/control/command-use3-test.cpp +++ b/tests/core/proc/control/command-use3-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file command-use3-test.cpp - ** unit test §§TODO§§ + ** unit test \ref CommandUse3_test */ diff --git a/tests/core/proc/control/handling-pattern-basics-test.cpp b/tests/core/proc/control/handling-pattern-basics-test.cpp index f18e7f44a..63e64bf1f 100644 --- a/tests/core/proc/control/handling-pattern-basics-test.cpp +++ b/tests/core/proc/control/handling-pattern-basics-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file handling-pattern-basics-test.cpp - ** unit test §§TODO§§ + ** unit test \ref HandlingPatternBasics_test */ diff --git a/tests/core/proc/control/handling-pattern-standard-impl-test.cpp b/tests/core/proc/control/handling-pattern-standard-impl-test.cpp index f1af4a298..42a44241e 100644 --- a/tests/core/proc/control/handling-pattern-standard-impl-test.cpp +++ b/tests/core/proc/control/handling-pattern-standard-impl-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file handling-pattern-standard-impl-test.cpp - ** unit test §§TODO§§ + ** unit test \ref HandlingPatternStandardImpl_test */ diff --git a/tests/core/proc/control/memento-tie-test.cpp b/tests/core/proc/control/memento-tie-test.cpp index 1ac4a2bea..c26c75411 100644 --- a/tests/core/proc/control/memento-tie-test.cpp +++ b/tests/core/proc/control/memento-tie-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file memento-tie-test.cpp - ** unit test §§TODO§§ + ** unit test \ref MementoTie_test */ diff --git a/tests/core/proc/control/test-dummy-commands.cpp b/tests/core/proc/control/test-dummy-commands.cpp index 2da0e4e7f..0eda0b953 100644 --- a/tests/core/proc/control/test-dummy-commands.cpp +++ b/tests/core/proc/control/test-dummy-commands.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file test-dummy-commands.cpp - ** unit test §§TODO§§ + ** Implementation of dummy command operations for unit tests */ diff --git a/tests/core/proc/engine/buff-table-test.cpp b/tests/core/proc/engine/buff-table-test.cpp index a9cac4693..3c439858e 100644 --- a/tests/core/proc/engine/buff-table-test.cpp +++ b/tests/core/proc/engine/buff-table-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file buff-table-test.cpp - ** unit test §§TODO§§ + ** unit test \ref BuffTable_test */ diff --git a/tests/core/proc/engine/buffer-metadata-key-test.cpp b/tests/core/proc/engine/buffer-metadata-key-test.cpp index e34247c7b..2f5dac3ba 100644 --- a/tests/core/proc/engine/buffer-metadata-key-test.cpp +++ b/tests/core/proc/engine/buffer-metadata-key-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file buffer-metadata-key-test.cpp - ** unit test §§TODO§§ + ** unit test \ref BufferMetadataKey_test */ diff --git a/tests/core/proc/engine/buffer-metadata-test.cpp b/tests/core/proc/engine/buffer-metadata-test.cpp index 54619ac6e..f6fea8c3e 100644 --- a/tests/core/proc/engine/buffer-metadata-test.cpp +++ b/tests/core/proc/engine/buffer-metadata-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file buffer-metadata-test.cpp - ** unit test §§TODO§§ + ** unit test \ref BufferMetadata_test */ diff --git a/tests/core/proc/engine/buffer-provider-protocol-test.cpp b/tests/core/proc/engine/buffer-provider-protocol-test.cpp index 4833b36e5..0c269aba5 100644 --- a/tests/core/proc/engine/buffer-provider-protocol-test.cpp +++ b/tests/core/proc/engine/buffer-provider-protocol-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file buffer-provider-protocol-test.cpp - ** unit test §§TODO§§ + ** unit test \ref BufferProviderProtocol_test */ diff --git a/tests/core/proc/engine/calc-stream-test.cpp b/tests/core/proc/engine/calc-stream-test.cpp index 7c529c48b..efbfe07b0 100644 --- a/tests/core/proc/engine/calc-stream-test.cpp +++ b/tests/core/proc/engine/calc-stream-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file calc-stream-test.cpp - ** unit test §§TODO§§ + ** unit test \ref CalcStream_test */ diff --git a/tests/core/proc/engine/dispatcher-interface-test.cpp b/tests/core/proc/engine/dispatcher-interface-test.cpp index 9e2c078b2..96298c695 100644 --- a/tests/core/proc/engine/dispatcher-interface-test.cpp +++ b/tests/core/proc/engine/dispatcher-interface-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file dispatcher-interface-test.cpp - ** unit test §§TODO§§ + ** unit test \ref DispatcherInterface_test */ diff --git a/tests/core/proc/engine/engine-interface-test.cpp b/tests/core/proc/engine/engine-interface-test.cpp index 21f8b140f..689a762d1 100644 --- a/tests/core/proc/engine/engine-interface-test.cpp +++ b/tests/core/proc/engine/engine-interface-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file engine-interface-test.cpp - ** unit test §§TODO§§ + ** unit test \ref EngineInterface_test */ diff --git a/tests/core/proc/engine/node-basic-test.cpp b/tests/core/proc/engine/node-basic-test.cpp index eeb22bde3..36ef79b76 100644 --- a/tests/core/proc/engine/node-basic-test.cpp +++ b/tests/core/proc/engine/node-basic-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file node-basic-test.cpp - ** unit test §§TODO§§ + ** unit test \ref NodeBasic_test */ diff --git a/tests/core/proc/engine/node-fabrication-test.cpp b/tests/core/proc/engine/node-fabrication-test.cpp index c9f39448d..78a2500ca 100644 --- a/tests/core/proc/engine/node-fabrication-test.cpp +++ b/tests/core/proc/engine/node-fabrication-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file node-fabrication-test.cpp - ** unit test §§TODO§§ + ** unit test \ref NodeFabrication_test */ diff --git a/tests/core/proc/engine/node-operation-test.cpp b/tests/core/proc/engine/node-operation-test.cpp index e60807171..65930421b 100644 --- a/tests/core/proc/engine/node-operation-test.cpp +++ b/tests/core/proc/engine/node-operation-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file node-operation-test.cpp - ** unit test §§TODO§§ + ** unit test \ref NodeOperation_test */ diff --git a/tests/core/proc/engine/node-source-test.cpp b/tests/core/proc/engine/node-source-test.cpp index 81d74032c..1b4a95390 100644 --- a/tests/core/proc/engine/node-source-test.cpp +++ b/tests/core/proc/engine/node-source-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file node-source-test.cpp - ** unit test §§TODO§§ + ** unit test \ref NodeSource_test */ diff --git a/tests/core/proc/engine/testframe-test.cpp b/tests/core/proc/engine/testframe-test.cpp index 10d4cbef6..4a4cdc8ed 100644 --- a/tests/core/proc/engine/testframe-test.cpp +++ b/tests/core/proc/engine/testframe-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file testframe-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TestFrame_test */ diff --git a/tests/core/proc/engine/tracking-heap-block-provider-test.cpp b/tests/core/proc/engine/tracking-heap-block-provider-test.cpp index 40b68b720..50b2a83e7 100644 --- a/tests/core/proc/engine/tracking-heap-block-provider-test.cpp +++ b/tests/core/proc/engine/tracking-heap-block-provider-test.cpp @@ -1,4 +1,4 @@ -/*u4 +/* TrackingHeapBlockProvider(Test) - verify a support facility for diagnostic/test purposes Copyright (C) Lumiera.org @@ -21,7 +21,7 @@ * *****************************************************/ /** @file tracking-heap-block-provider-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TrackingHeapBlockProvider_test */ diff --git a/tests/core/proc/mobject/builder/buildsegmenttest.cpp b/tests/core/proc/mobject/builder/build-segment-test.cpp similarity index 97% rename from tests/core/proc/mobject/builder/buildsegmenttest.cpp rename to tests/core/proc/mobject/builder/build-segment-test.cpp index aa0c1fff1..0d2c26ada 100644 --- a/tests/core/proc/mobject/builder/buildsegmenttest.cpp +++ b/tests/core/proc/mobject/builder/build-segment-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file buildsegmenttest.cpp - ** unit test §§TODO§§ + ** unit test \ref BuildSegment_test */ diff --git a/tests/core/proc/mobject/builder/buildertooltest.cpp b/tests/core/proc/mobject/builder/builder-tool-test.cpp similarity index 99% rename from tests/core/proc/mobject/builder/buildertooltest.cpp rename to tests/core/proc/mobject/builder/builder-tool-test.cpp index 49a2baa2d..d8e46cf87 100644 --- a/tests/core/proc/mobject/builder/buildertooltest.cpp +++ b/tests/core/proc/mobject/builder/builder-tool-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file buildertooltest.cpp - ** unit test §§TODO§§ + ** unit test \ref BuilderTool_test */ diff --git a/tests/core/proc/mobject/builder/fixture-change-detector-test.cpp b/tests/core/proc/mobject/builder/fixture-change-detector-test.cpp index e1dd1cd6f..71b344efc 100644 --- a/tests/core/proc/mobject/builder/fixture-change-detector-test.cpp +++ b/tests/core/proc/mobject/builder/fixture-change-detector-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file fixture-change-detector-test.cpp - ** unit test §§TODO§§ + ** unit test \ref FixtureChangeDetector_test */ @@ -87,7 +87,8 @@ namespace test { /*****************************************************************************//** - * @test TODO blubb + * @test planned test for detecting changes in a given segmentation + * @todo just a placeholder, nothing done here thus far (2016) * * @see mobject::builder::FixtureChangeDetector */ diff --git a/tests/core/proc/mobject/builder/model-port-registry-test.cpp b/tests/core/proc/mobject/builder/model-port-registry-test.cpp index 304c2d7b3..6fd756434 100644 --- a/tests/core/proc/mobject/builder/model-port-registry-test.cpp +++ b/tests/core/proc/mobject/builder/model-port-registry-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file model-port-registry-test.cpp - ** unit test §§TODO§§ + ** unit test \ref ModelPortRegistry_test */ diff --git a/tests/core/proc/mobject/builder/segmentation-datastructure-test.cpp b/tests/core/proc/mobject/builder/segmentation-datastructure-test.cpp index 25ac985f8..b517e554b 100644 --- a/tests/core/proc/mobject/builder/segmentation-datastructure-test.cpp +++ b/tests/core/proc/mobject/builder/segmentation-datastructure-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file segmentation-datastructure-test.cpp - ** unit test §§TODO§§ + ** unit test \ref SegmentationDatastructure_test */ diff --git a/tests/core/proc/mobject/controller/rendersegmenttest.cpp b/tests/core/proc/mobject/controller/render-segment-test.cpp similarity index 98% rename from tests/core/proc/mobject/controller/rendersegmenttest.cpp rename to tests/core/proc/mobject/controller/render-segment-test.cpp index 44b35ded7..189499b44 100644 --- a/tests/core/proc/mobject/controller/rendersegmenttest.cpp +++ b/tests/core/proc/mobject/controller/render-segment-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file rendersegmenttest.cpp - ** unit test §§TODO§§ + ** unit test \ref RenderSegment_test */ diff --git a/tests/core/proc/mobject/mobject-interface-test.cpp b/tests/core/proc/mobject/mobject-interface-test.cpp index d7cf0fe4f..698db1e7f 100644 --- a/tests/core/proc/mobject/mobject-interface-test.cpp +++ b/tests/core/proc/mobject/mobject-interface-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file mobject-interface-test.cpp - ** unit test §§TODO§§ + ** unit test \ref MObjectInterface_test */ diff --git a/tests/core/proc/mobject/mobject-ref-test.cpp b/tests/core/proc/mobject/mobject-ref-test.cpp index ab219b8c2..364d01e8e 100644 --- a/tests/core/proc/mobject/mobject-ref-test.cpp +++ b/tests/core/proc/mobject/mobject-ref-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file mobject-ref-test.cpp - ** unit test §§TODO§§ + ** unit test \ref MObjectRef_test */ diff --git a/tests/core/proc/mobject/output-mapping-test.cpp b/tests/core/proc/mobject/output-mapping-test.cpp index 3156759de..0b15714f1 100644 --- a/tests/core/proc/mobject/output-mapping-test.cpp +++ b/tests/core/proc/mobject/output-mapping-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file output-mapping-test.cpp - ** unit test §§TODO§§ + ** unit test \ref OutputMapping_test */ diff --git a/tests/core/proc/mobject/placement-basic-test.cpp b/tests/core/proc/mobject/placement-basic-test.cpp index e31276f24..6bb2d89ac 100644 --- a/tests/core/proc/mobject/placement-basic-test.cpp +++ b/tests/core/proc/mobject/placement-basic-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file placement-basic-test.cpp - ** unit test §§TODO§§ + ** unit test \ref PlacementBasic_test */ diff --git a/tests/core/proc/mobject/placement-hierarchy-test.cpp b/tests/core/proc/mobject/placement-hierarchy-test.cpp index ce19aa31d..a04d266a9 100644 --- a/tests/core/proc/mobject/placement-hierarchy-test.cpp +++ b/tests/core/proc/mobject/placement-hierarchy-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file placement-hierarchy-test.cpp - ** unit test §§TODO§§ + ** unit test \ref PlacementHierarchy_test */ diff --git a/tests/core/proc/mobject/placement-object-identity-test.cpp b/tests/core/proc/mobject/placement-object-identity-test.cpp index 9298e6400..e2a83b948 100644 --- a/tests/core/proc/mobject/placement-object-identity-test.cpp +++ b/tests/core/proc/mobject/placement-object-identity-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file placement-object-identity-test.cpp - ** unit test §§TODO§§ + ** unit test \ref PlacementObjectIdentity_test */ diff --git a/tests/core/proc/mobject/placement-ref-test.cpp b/tests/core/proc/mobject/placement-ref-test.cpp index b5c239524..38e642c3f 100644 --- a/tests/core/proc/mobject/placement-ref-test.cpp +++ b/tests/core/proc/mobject/placement-ref-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file placement-ref-test.cpp - ** unit test §§TODO§§ + ** unit test \ref PlacementRef_test */ diff --git a/tests/core/proc/mobject/session/addcliptest.cpp b/tests/core/proc/mobject/session/add-clip-test.cpp similarity index 98% rename from tests/core/proc/mobject/session/addcliptest.cpp rename to tests/core/proc/mobject/session/add-clip-test.cpp index 928c40238..2dd96bb45 100644 --- a/tests/core/proc/mobject/session/addcliptest.cpp +++ b/tests/core/proc/mobject/session/add-clip-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file addcliptest.cpp - ** unit test §§TODO§§ + ** unit test \ref AddClip_test */ diff --git a/tests/core/proc/mobject/session/defs-manager-impl-test.cpp b/tests/core/proc/mobject/session/defs-manager-impl-test.cpp index ec249a693..6289cd192 100644 --- a/tests/core/proc/mobject/session/defs-manager-impl-test.cpp +++ b/tests/core/proc/mobject/session/defs-manager-impl-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file defs-manager-impl-test.cpp - ** unit test §§TODO§§ + ** unit test \ref DefsManagerImpl_test */ diff --git a/tests/core/proc/mobject/session/defs-manager-test.cpp b/tests/core/proc/mobject/session/defs-manager-test.cpp index 5dbe64307..a7db7369e 100644 --- a/tests/core/proc/mobject/session/defs-manager-test.cpp +++ b/tests/core/proc/mobject/session/defs-manager-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file defs-manager-test.cpp - ** unit test §§TODO§§ + ** unit test \ref DefsManager_test */ diff --git a/tests/core/proc/mobject/session/defs-registry-impl-test.cpp b/tests/core/proc/mobject/session/defs-registry-impl-test.cpp index c8345e42b..49e016148 100644 --- a/tests/core/proc/mobject/session/defs-registry-impl-test.cpp +++ b/tests/core/proc/mobject/session/defs-registry-impl-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file defs-registry-impl-test.cpp - ** unit test §§TODO§§ + ** unit test \ref DefsRegistryImpl_test */ diff --git a/tests/core/proc/mobject/session/deletecliptest.cpp b/tests/core/proc/mobject/session/deletecliptest.cpp index 945ad6b88..a744c2336 100644 --- a/tests/core/proc/mobject/session/deletecliptest.cpp +++ b/tests/core/proc/mobject/session/deletecliptest.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file deletecliptest.cpp - ** unit test §§TODO§§ + ** unit test \ref DeleteClip_test */ diff --git a/tests/core/proc/mobject/session/placement-index-query-test.cpp b/tests/core/proc/mobject/session/placement-index-query-test.cpp index 285c950a5..b6409908f 100644 --- a/tests/core/proc/mobject/session/placement-index-query-test.cpp +++ b/tests/core/proc/mobject/session/placement-index-query-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file placement-index-query-test.cpp - ** unit test §§TODO§§ + ** unit test \ref PlacementIndexQuery_test */ diff --git a/tests/core/proc/mobject/session/placement-index-test.cpp b/tests/core/proc/mobject/session/placement-index-test.cpp index f7718cea3..85cddf015 100644 --- a/tests/core/proc/mobject/session/placement-index-test.cpp +++ b/tests/core/proc/mobject/session/placement-index-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file placement-index-test.cpp - ** unit test §§TODO§§ + ** unit test \ref PlacementIndex_test */ diff --git a/tests/core/proc/mobject/session/placement-scope-test.cpp b/tests/core/proc/mobject/session/placement-scope-test.cpp index d969e406a..01ae4e1c9 100644 --- a/tests/core/proc/mobject/session/placement-scope-test.cpp +++ b/tests/core/proc/mobject/session/placement-scope-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file placement-scope-test.cpp - ** unit test §§TODO§§ + ** unit test \ref PlacementScope_test */ diff --git a/tests/core/proc/mobject/session/query-focus-stack-test.cpp b/tests/core/proc/mobject/session/query-focus-stack-test.cpp index bcc3d0515..a98280ffa 100644 --- a/tests/core/proc/mobject/session/query-focus-stack-test.cpp +++ b/tests/core/proc/mobject/session/query-focus-stack-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file query-focus-stack-test.cpp - ** unit test §§TODO§§ + ** unit test \ref QueryFocusStack_test */ diff --git a/tests/core/proc/mobject/session/query-focus-test.cpp b/tests/core/proc/mobject/session/query-focus-test.cpp index 5ba8561a9..36b86372f 100644 --- a/tests/core/proc/mobject/session/query-focus-test.cpp +++ b/tests/core/proc/mobject/session/query-focus-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file query-focus-test.cpp - ** unit test §§TODO§§ + ** unit test \ref QueryFocus_test */ diff --git a/tests/core/proc/mobject/session/query-resolver-test.cpp b/tests/core/proc/mobject/session/query-resolver-test.cpp index 680fc5889..0e8e29519 100644 --- a/tests/core/proc/mobject/session/query-resolver-test.cpp +++ b/tests/core/proc/mobject/session/query-resolver-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file query-resolver-test.cpp - ** unit test §§TODO§§ + ** unit test \ref QueryResolver_test */ diff --git a/tests/core/proc/mobject/session/rebuildfixturetest.cpp b/tests/core/proc/mobject/session/rebuildfixturetest.cpp index 208c69fba..08ef95834 100644 --- a/tests/core/proc/mobject/session/rebuildfixturetest.cpp +++ b/tests/core/proc/mobject/session/rebuildfixturetest.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file rebuildfixturetest.cpp - ** unit test §§TODO§§ + ** unit test \ref RebuildFixture_test */ diff --git a/tests/core/proc/mobject/session/scope-path-test.cpp b/tests/core/proc/mobject/session/scope-path-test.cpp index 183c704a0..18e760999 100644 --- a/tests/core/proc/mobject/session/scope-path-test.cpp +++ b/tests/core/proc/mobject/session/scope-path-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file scope-path-test.cpp - ** unit test §§TODO§§ + ** unit test \ref ScopePath_test */ diff --git a/tests/core/proc/mobject/session/scope-query-test.cpp b/tests/core/proc/mobject/session/scope-query-test.cpp index b2603018a..c2206eae1 100644 --- a/tests/core/proc/mobject/session/scope-query-test.cpp +++ b/tests/core/proc/mobject/session/scope-query-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file scope-query-test.cpp - ** unit test §§TODO§§ + ** unit test \ref ScopeQuery_test */ diff --git a/tests/core/proc/mobject/session/session-element-query-test.cpp b/tests/core/proc/mobject/session/session-element-query-test.cpp index 95985742d..b75c54394 100644 --- a/tests/core/proc/mobject/session/session-element-query-test.cpp +++ b/tests/core/proc/mobject/session/session-element-query-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file session-element-query-test.cpp - ** unit test §§TODO§§ + ** unit test \ref SessionElementQuery_test */ diff --git a/tests/core/proc/mobject/session/session-element-tracker-test.cpp b/tests/core/proc/mobject/session/session-element-tracker-test.cpp index fd1ec184d..503141f49 100644 --- a/tests/core/proc/mobject/session/session-element-tracker-test.cpp +++ b/tests/core/proc/mobject/session/session-element-tracker-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file session-element-tracker-test.cpp - ** unit test §§TODO§§ + ** unit test \ref SessionElementTracker_test */ diff --git a/tests/core/proc/mobject/session/sessionmanagertest.cpp b/tests/core/proc/mobject/session/session-manager-test.cpp similarity index 99% rename from tests/core/proc/mobject/session/sessionmanagertest.cpp rename to tests/core/proc/mobject/session/session-manager-test.cpp index 866d54570..b02dad02c 100644 --- a/tests/core/proc/mobject/session/sessionmanagertest.cpp +++ b/tests/core/proc/mobject/session/session-manager-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file sessionmanagertest.cpp - ** unit test §§TODO§§ + ** unit test \ref SessionManager_test */ diff --git a/tests/core/proc/mobject/session/session-modify-parts-test.cpp b/tests/core/proc/mobject/session/session-modify-parts-test.cpp index a0ea1dde2..dabf20f79 100644 --- a/tests/core/proc/mobject/session/session-modify-parts-test.cpp +++ b/tests/core/proc/mobject/session/session-modify-parts-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file session-modify-parts-test.cpp - ** unit test §§TODO§§ + ** unit test \ref SessionModifyParts_test */ diff --git a/tests/core/proc/mobject/session/session-service-access-test.cpp b/tests/core/proc/mobject/session/session-service-access-test.cpp index e62437323..8a9cc46f4 100644 --- a/tests/core/proc/mobject/session/session-service-access-test.cpp +++ b/tests/core/proc/mobject/session/session-service-access-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file session-service-access-test.cpp - ** unit test §§TODO§§ + ** unit test \ref SessionServiceAccess_test */ diff --git a/tests/core/proc/mobject/session/session-structure-test.cpp b/tests/core/proc/mobject/session/session-structure-test.cpp index d742c65dd..e3d2ee0bf 100644 --- a/tests/core/proc/mobject/session/session-structure-test.cpp +++ b/tests/core/proc/mobject/session/session-structure-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file session-structure-test.cpp - ** unit test §§TODO§§ + ** unit test \ref SessionStructure_test */ diff --git a/tests/core/proc/mobject/session/timeline-sequence-handling-test.cpp b/tests/core/proc/mobject/session/timeline-sequence-handling-test.cpp index d07df4039..6249055fe 100644 --- a/tests/core/proc/mobject/session/timeline-sequence-handling-test.cpp +++ b/tests/core/proc/mobject/session/timeline-sequence-handling-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file timeline-sequence-handling-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TimelineSequenceHandling_test */ diff --git a/tests/core/proc/play/dummy-play-connection-test.cpp b/tests/core/proc/play/dummy-play-connection-test.cpp index 856bc3d4c..1d4ee4685 100644 --- a/tests/core/proc/play/dummy-play-connection-test.cpp +++ b/tests/core/proc/play/dummy-play-connection-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file dummy-play-connection-test.cpp - ** unit test §§TODO§§ + ** unit test \ref DummyPlayConnection_test */ diff --git a/tests/core/proc/play/output-slot-protocol-test.cpp b/tests/core/proc/play/output-slot-protocol-test.cpp index 47f1eb81c..46fa21097 100644 --- a/tests/core/proc/play/output-slot-protocol-test.cpp +++ b/tests/core/proc/play/output-slot-protocol-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file output-slot-protocol-test.cpp - ** unit test §§TODO§§ + ** unit test \ref OutputSlotProtocol_test */ diff --git a/tests/core/proc/play/timing-constraints-test.cpp b/tests/core/proc/play/timing-constraints-test.cpp index 336934391..14bca2d2f 100644 --- a/tests/core/proc/play/timing-constraints-test.cpp +++ b/tests/core/proc/play/timing-constraints-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file timing-constraints-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TimingConstraints_test */ diff --git a/tests/gui/bus-term-test.cpp b/tests/gui/bus-term-test.cpp index 697b54540..f432bef42 100644 --- a/tests/gui/bus-term-test.cpp +++ b/tests/gui/bus-term-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file bus-term-test.cpp - ** unit test §§TODO§§ + ** unit test \ref BusTerm_test */ diff --git a/tests/gui/interact/state-map-grouping-storage-test.cpp b/tests/gui/interact/state-map-grouping-storage-test.cpp index 1318e8fcc..aee518b8d 100644 --- a/tests/gui/interact/state-map-grouping-storage-test.cpp +++ b/tests/gui/interact/state-map-grouping-storage-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file state-map-grouping-storage-test.cpp - ** unit test §§TODO§§ + ** unit test \ref StateMapGroupingStorage_test */ diff --git a/tests/gui/test-gui-test.cpp b/tests/gui/test-gui-test.cpp index 3d90b3005..1947b2f70 100644 --- a/tests/gui/test-gui-test.cpp +++ b/tests/gui/test-gui-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file test-gui-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TestGui_test */ @@ -34,9 +34,13 @@ namespace gui { namespace test{ - /**************************************//** - * Hellooooooo the world is just a test - * @test demo of using the test framework + /************************************************************************************//** + * @test demo of writing a unit-test to execute code _implemented within the UI layer_. + * @note the point in question here is the build system and how library dependencies + * are handled. Typically such unit-tests will rather cover framework aspects + * of the UI, not perform a remote controlled execution of the UI. Thus we + * still create a commandline executable, but for this code to work, it + * needs to be _linked against the GUI plugin_ (which is in fact a shared library) */ class TestGui_test : public Test { @@ -49,16 +53,7 @@ namespace test{ - - - /** Register this test class to be invoked in some test groups (suites) - * @remarks this macro \c LUNCHER is defined in run.hpp to simplify - * the registration of test classes. It expands to the - * following static variable definition - * \code - * Launch run_HelloWorld_test("HelloWorld_test","unit common"); - * \endcode - */ + /** Register this test class to be invoked in some test groups */ LAUNCHER (TestGui_test, "unit gui"); diff --git a/tests/library/advice/advice-basics-test.cpp b/tests/library/advice/advice-basics-test.cpp index 814a958fa..ccb46e2dd 100644 --- a/tests/library/advice/advice-basics-test.cpp +++ b/tests/library/advice/advice-basics-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file advice-basics-test.cpp - ** unit test §§TODO§§ + ** unit test \ref AdviceBasics_test */ diff --git a/tests/library/advice/advice-binding-pattern-test.cpp b/tests/library/advice/advice-binding-pattern-test.cpp index b985e543e..33a371d7f 100644 --- a/tests/library/advice/advice-binding-pattern-test.cpp +++ b/tests/library/advice/advice-binding-pattern-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file advice-binding-pattern-test.cpp - ** unit test §§TODO§§ + ** unit test \ref AdviceBindingPattern_test */ diff --git a/tests/library/advice/advice-configuration-test.cpp b/tests/library/advice/advice-configuration-test.cpp index 69733ffc4..496de1df7 100644 --- a/tests/library/advice/advice-configuration-test.cpp +++ b/tests/library/advice/advice-configuration-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file advice-configuration-test.cpp - ** unit test §§TODO§§ + ** unit test \ref AdviceConfiguration_test */ diff --git a/tests/library/advice/advice-index-test.cpp b/tests/library/advice/advice-index-test.cpp index 19b919e12..65da2eb9f 100644 --- a/tests/library/advice/advice-index-test.cpp +++ b/tests/library/advice/advice-index-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file advice-index-test.cpp - ** unit test §§TODO§§ + ** unit test \ref AdviceIndex_test */ diff --git a/tests/library/advice/advice-multiplicity-test.cpp b/tests/library/advice/advice-multiplicity-test.cpp index ab45743d5..a6fd7f8b3 100644 --- a/tests/library/advice/advice-multiplicity-test.cpp +++ b/tests/library/advice/advice-multiplicity-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file advice-multiplicity-test.cpp - ** unit test §§TODO§§ + ** unit test \ref AdviceMultiplicity_test */ diff --git a/tests/library/advice/advice-situations-test.cpp b/tests/library/advice/advice-situations-test.cpp index 63fe1a836..7b5c3236e 100644 --- a/tests/library/advice/advice-situations-test.cpp +++ b/tests/library/advice/advice-situations-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file advice-situations-test.cpp - ** unit test §§TODO§§ + ** unit test \ref AdviceSituations_test */ diff --git a/tests/library/allocation-cluster-test.cpp b/tests/library/allocation-cluster-test.cpp index f54daf12c..056732e5b 100644 --- a/tests/library/allocation-cluster-test.cpp +++ b/tests/library/allocation-cluster-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file allocation-cluster-test.cpp - ** unit test §§TODO§§ + ** unit test \ref AllocationCluster_test */ diff --git a/tests/library/app-config-test.cpp b/tests/library/app-config-test.cpp index eba0ac69b..6f4c78b02 100644 --- a/tests/library/app-config-test.cpp +++ b/tests/library/app-config-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file app-config-test.cpp - ** unit test §§TODO§§ + ** unit test \ref Appconfig_test */ diff --git a/tests/library/bool-checkable-test.cpp b/tests/library/bool-checkable-test.cpp index b258b15fb..ae1a3c1c8 100644 --- a/tests/library/bool-checkable-test.cpp +++ b/tests/library/bool-checkable-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file bool-checkable-test.cpp - ** unit test §§TODO§§ + ** unit test \ref BoolCheckable_test */ diff --git a/tests/library/cmdline-wrapper-test.cpp b/tests/library/cmdline-wrapper-test.cpp index 1135faeb2..0796f4518 100644 --- a/tests/library/cmdline-wrapper-test.cpp +++ b/tests/library/cmdline-wrapper-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file cmdline-wrapper-test.cpp - ** unit test §§TODO§§ + ** unit test \ref CmdlineWrapper_test */ diff --git a/tests/library/custom-shared-ptr-test.cpp b/tests/library/custom-shared-ptr-test.cpp index f26098165..97123833d 100644 --- a/tests/library/custom-shared-ptr-test.cpp +++ b/tests/library/custom-shared-ptr-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file custom-shared-ptr-test.cpp - ** unit test §§TODO§§ + ** unit test \ref CustomSharedPtr_test */ diff --git a/tests/library/del-stash-test.cpp b/tests/library/del-stash-test.cpp index 26363dbff..08b9172c9 100644 --- a/tests/library/del-stash-test.cpp +++ b/tests/library/del-stash-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file del-stash-test.cpp - ** unit test §§TODO§§ + ** unit test \ref DelStash_test */ diff --git a/tests/library/dependency-factory-test.cpp b/tests/library/dependency-factory-test.cpp index 106900df1..7dca01d61 100644 --- a/tests/library/dependency-factory-test.cpp +++ b/tests/library/dependency-factory-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file dependency-factory-test.cpp - ** unit test §§TODO§§ + ** unit test \ref DependencyFactory_test */ diff --git a/tests/library/diff/diff-complex-application-test.cpp b/tests/library/diff/diff-complex-application-test.cpp index e5faa340b..5b4fff122 100644 --- a/tests/library/diff/diff-complex-application-test.cpp +++ b/tests/library/diff/diff-complex-application-test.cpp @@ -1,5 +1,5 @@ /* - DiffVirtualisedApplication(Test) - apply structural changes to unspecific private data structures + DiffComplexApplication(Test) - apply structural changes to unspecific private data structures Copyright (C) Lumiera.org 2016, Hermann Vosseler @@ -21,7 +21,7 @@ * *****************************************************/ /** @file diff-complex-application-test.cpp - ** unit test §§TODO§§ + ** unit test \ref DiffComplexApplication_test */ diff --git a/tests/library/diff/diff-index-table-test.cpp b/tests/library/diff/diff-index-table-test.cpp index 7bc618bdb..ad9a8946c 100644 --- a/tests/library/diff/diff-index-table-test.cpp +++ b/tests/library/diff/diff-index-table-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file diff-index-table-test.cpp - ** unit test §§TODO§§ + ** unit test \ref DiffIndexTable_test */ diff --git a/tests/library/diff/diff-list-application-test.cpp b/tests/library/diff/diff-list-application-test.cpp index 86f580806..30f0348e7 100644 --- a/tests/library/diff/diff-list-application-test.cpp +++ b/tests/library/diff/diff-list-application-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file diff-list-application-test.cpp - ** unit test §§TODO§§ + ** unit test \ref DiffListApplication_test */ diff --git a/tests/library/diff/diff-list-generation-test.cpp b/tests/library/diff/diff-list-generation-test.cpp index f6d0172c6..794f46c1f 100644 --- a/tests/library/diff/diff-list-generation-test.cpp +++ b/tests/library/diff/diff-list-generation-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file diff-list-generation-test.cpp - ** unit test §§TODO§§ + ** unit test \ref DiffListGeneration_test */ diff --git a/tests/library/diff/diff-tree-application-test.cpp b/tests/library/diff/diff-tree-application-test.cpp index 412234f8d..9f16b3dea 100644 --- a/tests/library/diff/diff-tree-application-test.cpp +++ b/tests/library/diff/diff-tree-application-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file diff-tree-application-test.cpp - ** unit test §§TODO§§ + ** unit test \ref DiffTreeApplication_test */ diff --git a/tests/library/diff/gen-node-basic-test.cpp b/tests/library/diff/gen-node-basic-test.cpp index adb65d6dc..0608db467 100644 --- a/tests/library/diff/gen-node-basic-test.cpp +++ b/tests/library/diff/gen-node-basic-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file gen-node-basic-test.cpp - ** unit test §§TODO§§ + ** unit test \ref GenNodeBasic_test */ diff --git a/tests/library/diff/generic-record-representation-test.cpp b/tests/library/diff/generic-record-representation-test.cpp index 79cae0cf3..1bd5c6328 100644 --- a/tests/library/diff/generic-record-representation-test.cpp +++ b/tests/library/diff/generic-record-representation-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file generic-record-representation-test.cpp - ** unit test §§TODO§§ + ** unit test \ref GenericRecordRepresentation_test */ diff --git a/tests/library/diff/tree-mutator-binding-test.cpp b/tests/library/diff/tree-mutator-binding-test.cpp index 8411b24e9..56df7c00e 100644 --- a/tests/library/diff/tree-mutator-binding-test.cpp +++ b/tests/library/diff/tree-mutator-binding-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file tree-mutator-binding-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TreeMutatorBinding_test */ diff --git a/tests/library/diff/tree-mutator-test.cpp b/tests/library/diff/tree-mutator-test.cpp index 3b8533be3..a6ca65d11 100644 --- a/tests/library/diff/tree-mutator-test.cpp +++ b/tests/library/diff/tree-mutator-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file tree-mutator-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TreeMutator_test */ diff --git a/tests/library/exceptionerrortest.cpp b/tests/library/exception-error-test.cpp similarity index 99% rename from tests/library/exceptionerrortest.cpp rename to tests/library/exception-error-test.cpp index 979117c50..d057f2578 100644 --- a/tests/library/exceptionerrortest.cpp +++ b/tests/library/exception-error-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file exceptionerrortest.cpp - ** unit test §§TODO§§ + ** unit test \ref ExceptionError_test */ diff --git a/tests/library/format-cout-test.cpp b/tests/library/format-cout-test.cpp index 4387f4322..b876c24ba 100644 --- a/tests/library/format-cout-test.cpp +++ b/tests/library/format-cout-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file format-cout-test.cpp - ** unit test §§TODO§§ + ** unit test \ref FormatCOUT_test */ diff --git a/tests/library/format-helper-test.cpp b/tests/library/format-helper-test.cpp index c548ab517..eb1c46f5e 100644 --- a/tests/library/format-helper-test.cpp +++ b/tests/library/format-helper-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file format-helper-test.cpp - ** unit test §§TODO§§ + ** unit test \ref FormatHelper_test */ diff --git a/tests/library/format-string-test.cpp b/tests/library/format-string-test.cpp index f9b2377ac..094a9de03 100644 --- a/tests/library/format-string-test.cpp +++ b/tests/library/format-string-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file format-string-test.cpp - ** unit test §§TODO§§ + ** unit test \ref FormatString_test */ diff --git a/tests/library/functor-util-test.cpp b/tests/library/functor-util-test.cpp index 81546bf75..da5a29f3c 100644 --- a/tests/library/functor-util-test.cpp +++ b/tests/library/functor-util-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file functor-util-test.cpp - ** unit test §§TODO§§ + ** unit test \ref FunctorUtil_test */ diff --git a/tests/library/hash-generator-test.cpp b/tests/library/hash-generator-test.cpp index 11d7fc782..4bcbebed1 100644 --- a/tests/library/hash-generator-test.cpp +++ b/tests/library/hash-generator-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file hash-generator-test.cpp - ** unit test §§TODO§§ + ** unit test \ref HashGenerator_test */ diff --git a/tests/library/hash-indexed-test.cpp b/tests/library/hash-indexed-test.cpp index 677fc6aa7..ad84be5fe 100644 --- a/tests/library/hash-indexed-test.cpp +++ b/tests/library/hash-indexed-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file hash-indexed-test.cpp - ** unit test §§TODO§§ + ** unit test \ref HashIndexed_test */ diff --git a/tests/library/hash-standard-to-boost-bridge-test.cpp b/tests/library/hash-standard-to-boost-bridge-test.cpp index a1dda903e..27325e9d1 100644 --- a/tests/library/hash-standard-to-boost-bridge-test.cpp +++ b/tests/library/hash-standard-to-boost-bridge-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file hash-standard-to-boost-bridge-test.cpp - ** unit test §§TODO§§ + ** unit test \ref HashStandardToBoostBridge_test */ diff --git a/tests/library/helloworldtest.cpp b/tests/library/helloworldtest.cpp index b14e46463..f0993fc78 100644 --- a/tests/library/helloworldtest.cpp +++ b/tests/library/helloworldtest.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file helloworldtest.cpp - ** unit test §§TODO§§ + ** unit test \ref HelloWorld_test */ diff --git a/tests/library/hierarchy-orientation-indicator-test.cpp b/tests/library/hierarchy-orientation-indicator-test.cpp index d55bed459..b3a375b7a 100644 --- a/tests/library/hierarchy-orientation-indicator-test.cpp +++ b/tests/library/hierarchy-orientation-indicator-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file hierarchy-orientation-indicator-test.cpp - ** unit test §§TODO§§ + ** unit test \ref HierarchyOrientationIndicator_test */ diff --git a/tests/library/idi/generic-id-function-test.cpp b/tests/library/idi/generic-id-function-test.cpp index f1a0af92b..6951cddaf 100644 --- a/tests/library/idi/generic-id-function-test.cpp +++ b/tests/library/idi/generic-id-function-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file generic-id-function-test.cpp - ** unit test §§TODO§§ + ** unit test \ref GenericIdFunction_test */ diff --git a/tests/library/item-wrapper-test.cpp b/tests/library/item-wrapper-test.cpp index 66a95f29c..c8d585635 100644 --- a/tests/library/item-wrapper-test.cpp +++ b/tests/library/item-wrapper-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file item-wrapper-test.cpp - ** unit test §§TODO§§ + ** unit test \ref ItemWrapper_test */ diff --git a/tests/library/iter-adapter-stl-test.cpp b/tests/library/iter-adapter-stl-test.cpp index 8e6881299..f4783da82 100644 --- a/tests/library/iter-adapter-stl-test.cpp +++ b/tests/library/iter-adapter-stl-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file iter-adapter-stl-test.cpp - ** unit test §§TODO§§ + ** unit test \ref IterAdapterSTL_test */ diff --git a/tests/library/iter-adapter-test.cpp b/tests/library/iter-adapter-test.cpp index 8b604b8a7..b60f268cc 100644 --- a/tests/library/iter-adapter-test.cpp +++ b/tests/library/iter-adapter-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file iter-adapter-test.cpp - ** unit test §§TODO§§ + ** unit test \ref IterAdapter_test */ diff --git a/tests/library/iter-cursor-test.cpp b/tests/library/iter-cursor-test.cpp index 57b9b0a00..64a1604b7 100644 --- a/tests/library/iter-cursor-test.cpp +++ b/tests/library/iter-cursor-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file iter-cursor-test.cpp - ** unit test §§TODO§§ + ** unit test \ref IterCursor_test */ diff --git a/tests/library/iter-explorer-test.cpp b/tests/library/iter-explorer-test.cpp index 4737912c0..ad7673a8b 100644 --- a/tests/library/iter-explorer-test.cpp +++ b/tests/library/iter-explorer-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file iter-explorer-test.cpp - ** unit test §§TODO§§ + ** unit test \ref IterExplorer_test */ diff --git a/tests/library/iter-queue-test.cpp b/tests/library/iter-queue-test.cpp index 8dcf8902a..1000fe573 100644 --- a/tests/library/iter-queue-test.cpp +++ b/tests/library/iter-queue-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file iter-queue-test.cpp - ** unit test §§TODO§§ + ** unit test \ref IterQueue_test */ diff --git a/tests/library/iter-source-test.cpp b/tests/library/iter-source-test.cpp index 895ae7450..a5740a199 100644 --- a/tests/library/iter-source-test.cpp +++ b/tests/library/iter-source-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file iter-source-test.cpp - ** unit test §§TODO§§ + ** unit test \ref IterSource_test */ diff --git a/tests/library/iter-stack-test.cpp b/tests/library/iter-stack-test.cpp index 455b851ca..3be69c5c8 100644 --- a/tests/library/iter-stack-test.cpp +++ b/tests/library/iter-stack-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file iter-stack-test.cpp - ** unit test §§TODO§§ + ** unit test \ref IterStack_test */ diff --git a/tests/library/itertools-test.cpp b/tests/library/itertools-test.cpp index aabab2460..ca7fddc1e 100644 --- a/tests/library/itertools-test.cpp +++ b/tests/library/itertools-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file itertools-test.cpp - ** unit test §§TODO§§ + ** unit test \ref IterTools_test */ diff --git a/tests/library/lifecycletest.cpp b/tests/library/life-cycle-test.cpp similarity index 98% rename from tests/library/lifecycletest.cpp rename to tests/library/life-cycle-test.cpp index 34894349f..573a8be03 100644 --- a/tests/library/lifecycletest.cpp +++ b/tests/library/life-cycle-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file lifecycletest.cpp - ** unit test §§TODO§§ + ** unit test \ref LifeCycle_test */ diff --git a/tests/library/linked-elements-test.cpp b/tests/library/linked-elements-test.cpp index 2e0a1d9b0..3ec022087 100644 --- a/tests/library/linked-elements-test.cpp +++ b/tests/library/linked-elements-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file linked-elements-test.cpp - ** unit test §§TODO§§ + ** unit test \ref LinkedElements_test */ diff --git a/tests/library/maybe-value-test.cpp b/tests/library/maybe-value-test.cpp index 83d59d3df..a5630af9d 100644 --- a/tests/library/maybe-value-test.cpp +++ b/tests/library/maybe-value-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file maybe-value-test.cpp - ** unit test §§TODO§§ + ** unit test \ref MaybeValue_test */ diff --git a/tests/library/meta/access-casted-test.cpp b/tests/library/meta/access-casted-test.cpp index 5b5724200..e6ad2f55a 100644 --- a/tests/library/meta/access-casted-test.cpp +++ b/tests/library/meta/access-casted-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file access-casted-test.cpp - ** unit test §§TODO§§ + ** unit test \ref AccessCasted_test */ diff --git a/tests/library/meta/duck-detector-test.cpp b/tests/library/meta/duck-detector-test.cpp index 354420971..fe14f1be0 100644 --- a/tests/library/meta/duck-detector-test.cpp +++ b/tests/library/meta/duck-detector-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file duck-detector-test.cpp - ** unit test §§TODO§§ + ** unit test \ref DuckDetector_test */ diff --git a/tests/library/meta/function-composition-test.cpp b/tests/library/meta/function-composition-test.cpp index 10902db45..ccbd468a0 100644 --- a/tests/library/meta/function-composition-test.cpp +++ b/tests/library/meta/function-composition-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file function-composition-test.cpp - ** unit test §§TODO§§ + ** unit test \ref FunctionComposition_test */ diff --git a/tests/library/meta/function-erasure-test.cpp b/tests/library/meta/function-erasure-test.cpp index fb0532d0d..bb66d91b5 100644 --- a/tests/library/meta/function-erasure-test.cpp +++ b/tests/library/meta/function-erasure-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file function-erasure-test.cpp - ** unit test §§TODO§§ + ** unit test \ref FunctionErasure_test */ diff --git a/tests/library/meta/generator-combinations-test.cpp b/tests/library/meta/generator-combinations-test.cpp index 0d541d359..8ce8b7f43 100644 --- a/tests/library/meta/generator-combinations-test.cpp +++ b/tests/library/meta/generator-combinations-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file generator-combinations-test.cpp - ** unit test §§TODO§§ + ** unit test \ref GeneratorCombinations_test */ diff --git a/tests/library/meta/iterable-classification-test.cpp b/tests/library/meta/iterable-classification-test.cpp index a38a70316..3c5e0b3c0 100644 --- a/tests/library/meta/iterable-classification-test.cpp +++ b/tests/library/meta/iterable-classification-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file iterable-classification-test.cpp - ** unit test §§TODO§§ + ** unit test \ref IterableClassification_test */ diff --git a/tests/library/meta/meta-utils-test.cpp b/tests/library/meta/meta-utils-test.cpp index 3d2fcc3cc..db14c6d00 100644 --- a/tests/library/meta/meta-utils-test.cpp +++ b/tests/library/meta/meta-utils-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file meta-utils-test.cpp - ** unit test §§TODO§§ + ** unit test \ref MetaUtils_test */ diff --git a/tests/library/meta/tuple-record-init-test.cpp b/tests/library/meta/tuple-record-init-test.cpp index edbca2920..65c73a50f 100644 --- a/tests/library/meta/tuple-record-init-test.cpp +++ b/tests/library/meta/tuple-record-init-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file tuple-record-init-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TupleRecordInit_test */ ///@file diff --git a/tests/library/meta/type-demangling-test.cpp b/tests/library/meta/type-demangling-test.cpp index b380f8ede..3257b0900 100644 --- a/tests/library/meta/type-demangling-test.cpp +++ b/tests/library/meta/type-demangling-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file type-demangling-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TypeDemangling_test */ diff --git a/tests/library/meta/type-display-test.cpp b/tests/library/meta/type-display-test.cpp index ed22d4e53..e20ad3300 100644 --- a/tests/library/meta/type-display-test.cpp +++ b/tests/library/meta/type-display-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file type-display-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TypeDisplay_test */ diff --git a/tests/library/meta/typelist-test.cpp b/tests/library/meta/typelist-test.cpp index 4a31dbcf2..404ad1d19 100644 --- a/tests/library/meta/typelist-test.cpp +++ b/tests/library/meta/typelist-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file typelist-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TypeList_test */ diff --git a/tests/library/meta/typelist-util-test.cpp b/tests/library/meta/typelist-util-test.cpp index fb93a157d..c7b2fee47 100644 --- a/tests/library/meta/typelist-util-test.cpp +++ b/tests/library/meta/typelist-util-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file typelist-util-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TypeListUtil_test */ diff --git a/tests/library/meta/virtual-copy-support-test.cpp b/tests/library/meta/virtual-copy-support-test.cpp index 9adf6886a..544020262 100644 --- a/tests/library/meta/virtual-copy-support-test.cpp +++ b/tests/library/meta/virtual-copy-support-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file virtual-copy-support-test.cpp - ** unit test §§TODO§§ + ** unit test \ref VirtualCopySupport_test */ diff --git a/tests/library/multifact-argument-test.cpp b/tests/library/multifact-argument-test.cpp index ef30ccbf5..0983feacb 100644 --- a/tests/library/multifact-argument-test.cpp +++ b/tests/library/multifact-argument-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file multifact-argument-test.cpp - ** unit test §§TODO§§ + ** unit test \ref MultiFactArgument_test */ diff --git a/tests/library/multifact-singleton-test.cpp b/tests/library/multifact-singleton-test.cpp index 377303b17..a448a651c 100644 --- a/tests/library/multifact-singleton-test.cpp +++ b/tests/library/multifact-singleton-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file multifact-singleton-test.cpp - ** unit test §§TODO§§ + ** unit test \ref MultiFactSingleton_test */ diff --git a/tests/library/multifact-test.cpp b/tests/library/multifact-test.cpp index f99b9d6fc..b716c0878 100644 --- a/tests/library/multifact-test.cpp +++ b/tests/library/multifact-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file multifact-test.cpp - ** unit test §§TODO§§ + ** unit test \ref MultiFact_test */ diff --git a/tests/library/null-value-test.cpp b/tests/library/null-value-test.cpp index 34d144788..31f387f7b 100644 --- a/tests/library/null-value-test.cpp +++ b/tests/library/null-value-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file null-value-test.cpp - ** unit test §§TODO§§ + ** unit test \ref NullValue_test */ diff --git a/tests/library/opaque-holder-test.cpp b/tests/library/opaque-holder-test.cpp index daed90748..cc8a8a371 100644 --- a/tests/library/opaque-holder-test.cpp +++ b/tests/library/opaque-holder-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file opaque-holder-test.cpp - ** unit test §§TODO§§ + ** unit test \ref OpaqueHolder_test */ diff --git a/tests/library/opaque-unchecked-buffer-test.cpp b/tests/library/opaque-unchecked-buffer-test.cpp index d34876447..c06abc6ab 100644 --- a/tests/library/opaque-unchecked-buffer-test.cpp +++ b/tests/library/opaque-unchecked-buffer-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file opaque-unchecked-buffer-test.cpp - ** unit test §§TODO§§ + ** unit test \ref OpaqueUncheckedBuffer_test */ diff --git a/tests/library/optional-ref-test.cpp b/tests/library/optional-ref-test.cpp index 180fc2e77..fa6648e2f 100644 --- a/tests/library/optional-ref-test.cpp +++ b/tests/library/optional-ref-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file optional-ref-test.cpp - ** unit test §§TODO§§ + ** unit test \ref OptionalRef_test */ diff --git a/tests/library/polymorphic-value-test.cpp b/tests/library/polymorphic-value-test.cpp index 0be0be73b..41a23c968 100644 --- a/tests/library/polymorphic-value-test.cpp +++ b/tests/library/polymorphic-value-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file polymorphic-value-test.cpp - ** unit test §§TODO§§ + ** unit test \ref PolymorphicValue_test */ diff --git a/tests/library/query-text-test.cpp b/tests/library/query-text-test.cpp index 4bd09335f..a3af0ed71 100644 --- a/tests/library/query-text-test.cpp +++ b/tests/library/query-text-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file query-text-test.cpp - ** unit test §§TODO§§ + ** unit test \ref QueryText_test */ diff --git a/tests/library/query/query-utils-test.cpp b/tests/library/query/query-utils-test.cpp index 6d31f2a9d..c513b2e5e 100644 --- a/tests/library/query/query-utils-test.cpp +++ b/tests/library/query/query-utils-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file query-utils-test.cpp - ** unit test §§TODO§§ + ** unit test \ref QueryUtils_test */ diff --git a/tests/library/ref-array-test.cpp b/tests/library/ref-array-test.cpp index 4a0c2cc1c..bd98dbcff 100644 --- a/tests/library/ref-array-test.cpp +++ b/tests/library/ref-array-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file ref-array-test.cpp - ** unit test §§TODO§§ + ** unit test \ref RefArray_test */ diff --git a/tests/library/removefromsettest.cpp b/tests/library/removefromsettest.cpp index 5ac38aba9..7044ce3ad 100644 --- a/tests/library/removefromsettest.cpp +++ b/tests/library/removefromsettest.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file removefromsettest.cpp - ** unit test §§TODO§§ + ** unit test \ref RemoveFromSet_test */ diff --git a/tests/library/sanitised-identifier-test.cpp b/tests/library/sanitised-identifier-test.cpp index 47d24d680..7d7ce6d18 100644 --- a/tests/library/sanitised-identifier-test.cpp +++ b/tests/library/sanitised-identifier-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file sanitised-identifier-test.cpp - ** unit test §§TODO§§ + ** unit test \ref SanitizedIdentifier_test */ diff --git a/tests/library/scoped-collection-test.cpp b/tests/library/scoped-collection-test.cpp index 38404b319..0e1c5e707 100644 --- a/tests/library/scoped-collection-test.cpp +++ b/tests/library/scoped-collection-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file scoped-collection-test.cpp - ** unit test §§TODO§§ + ** unit test \ref ScopedCollection_test */ diff --git a/tests/library/scoped-holder-test.cpp b/tests/library/scoped-holder-test.cpp index 41850bffd..c8549a6be 100644 --- a/tests/library/scoped-holder-test.cpp +++ b/tests/library/scoped-holder-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file scoped-holder-test.cpp - ** unit test §§TODO§§ + ** unit test \ref ScopedHolder_test */ diff --git a/tests/library/scoped-holder-transfer-test.cpp b/tests/library/scoped-holder-transfer-test.cpp index cdc56870c..d6b9abe60 100644 --- a/tests/library/scoped-holder-transfer-test.cpp +++ b/tests/library/scoped-holder-transfer-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file scoped-holder-transfer-test.cpp - ** unit test §§TODO§§ + ** unit test \ref ScopedHolderTransfer_test */ diff --git a/tests/library/scoped-ptrvect-test.cpp b/tests/library/scoped-ptrvect-test.cpp index f9027ba93..004a6d754 100644 --- a/tests/library/scoped-ptrvect-test.cpp +++ b/tests/library/scoped-ptrvect-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file scoped-ptrvect-test.cpp - ** unit test §§TODO§§ + ** unit test \ref ScopedPtrVect_test */ diff --git a/tests/library/search-path-splitter-test.cpp b/tests/library/search-path-splitter-test.cpp index 6cb859623..4dedad651 100644 --- a/tests/library/search-path-splitter-test.cpp +++ b/tests/library/search-path-splitter-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file search-path-splitter-test.cpp - ** unit test §§TODO§§ + ** unit test \ref SearchPathSplitter_test */ diff --git a/tests/library/simple-allocator-test.cpp b/tests/library/simple-allocator-test.cpp index c047de152..a7e7a3ac7 100644 --- a/tests/library/simple-allocator-test.cpp +++ b/tests/library/simple-allocator-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file simple-allocator-test.cpp - ** unit test §§TODO§§ + ** unit test \ref SimpleAllocator_test */ diff --git a/tests/library/singleton-subclass-test.cpp b/tests/library/singleton-subclass-test.cpp index d3a188955..521189a35 100644 --- a/tests/library/singleton-subclass-test.cpp +++ b/tests/library/singleton-subclass-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file singleton-subclass-test.cpp - ** unit test §§TODO§§ + ** unit test \ref SingletonSubclass_test */ diff --git a/tests/library/singleton-test.cpp b/tests/library/singleton-test.cpp index d356ff56d..1fd565fb4 100644 --- a/tests/library/singleton-test.cpp +++ b/tests/library/singleton-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file singleton-test.cpp - ** unit test §§TODO§§ + ** unit test \ref Singleton_test */ diff --git a/tests/library/singleton-testmock-test.cpp b/tests/library/singleton-testmock-test.cpp index 2c6cc8edb..8749b7957 100644 --- a/tests/library/singleton-testmock-test.cpp +++ b/tests/library/singleton-testmock-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file singleton-testmock-test.cpp - ** unit test §§TODO§§ + ** unit test \ref SingletonTestMock_test */ diff --git a/tests/library/sub-id-test.cpp b/tests/library/sub-id-test.cpp index 64f41650e..b4ea5fc4d 100644 --- a/tests/library/sub-id-test.cpp +++ b/tests/library/sub-id-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file sub-id-test.cpp - ** unit test §§TODO§§ + ** unit test \ref SubID_test */ diff --git a/tests/library/symbol-hashtable-test.cpp b/tests/library/symbol-hashtable-test.cpp index 247a87f59..dbc9ea565 100644 --- a/tests/library/symbol-hashtable-test.cpp +++ b/tests/library/symbol-hashtable-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file symbol-hashtable-test.cpp - ** unit test §§TODO§§ + ** unit test \ref SymbolHashtable_test */ diff --git a/tests/library/symbol-test.cpp b/tests/library/symbol-test.cpp index 5d1023c22..c0f4168aa 100644 --- a/tests/library/symbol-test.cpp +++ b/tests/library/symbol-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file symbol-test.cpp - ** unit test §§TODO§§ + ** unit test \ref Symbol_test */ diff --git a/tests/library/test/test-event-log-test.cpp b/tests/library/test/test-event-log-test.cpp index 287f8515d..18ac7c2ac 100644 --- a/tests/library/test/test-event-log-test.cpp +++ b/tests/library/test/test-event-log-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file test-event-log-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TestEventLog_test */ diff --git a/tests/library/test/test-helper-test.cpp b/tests/library/test/test-helper-test.cpp index d46a6be77..a9335a02a 100644 --- a/tests/library/test/test-helper-test.cpp +++ b/tests/library/test/test-helper-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file test-helper-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TestHelper_test */ diff --git a/tests/library/test/test-helper-variadic-test.cpp b/tests/library/test/test-helper-variadic-test.cpp index e8c9d129b..8f7606cf9 100644 --- a/tests/library/test/test-helper-variadic-test.cpp +++ b/tests/library/test/test-helper-variadic-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file test-helper-variadic-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TestHelperVariadic_test */ diff --git a/tests/library/test/test-option-test.cpp b/tests/library/test/test-option-test.cpp index 2283020c6..dfb47bfeb 100644 --- a/tests/library/test/test-option-test.cpp +++ b/tests/library/test/test-option-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file test-option-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TestOption_test */ diff --git a/tests/library/typed-allocation-manager-test.cpp b/tests/library/typed-allocation-manager-test.cpp index bee4fed72..17e8eb6fb 100644 --- a/tests/library/typed-allocation-manager-test.cpp +++ b/tests/library/typed-allocation-manager-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file typed-allocation-manager-test.cpp - ** unit test §§TODO§§ + ** unit test \ref TypedAllocationManager_test */ diff --git a/tests/library/unique-malloc-owner-test.cpp b/tests/library/unique-malloc-owner-test.cpp index e558f28aa..11c500456 100644 --- a/tests/library/unique-malloc-owner-test.cpp +++ b/tests/library/unique-malloc-owner-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file unique-malloc-owner-test.cpp - ** unit test §§TODO§§ + ** unit test \ref UniqueMallocOwner_test */ diff --git a/tests/library/util-collection-test.cpp b/tests/library/util-collection-test.cpp index 176ffb045..eb6292598 100644 --- a/tests/library/util-collection-test.cpp +++ b/tests/library/util-collection-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file util-collection-test.cpp - ** unit test §§TODO§§ + ** unit test \ref UtilCollection_test */ diff --git a/tests/library/util-floordiv-test.cpp b/tests/library/util-floordiv-test.cpp index cc8035463..766e41b41 100644 --- a/tests/library/util-floordiv-test.cpp +++ b/tests/library/util-floordiv-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file util-floordiv-test.cpp - ** unit test §§TODO§§ + ** unit test \ref UtilFloordiv_test */ diff --git a/tests/library/util-floorwrap-test.cpp b/tests/library/util-floorwrap-test.cpp index c859dcdc8..b4a23e83c 100644 --- a/tests/library/util-floorwrap-test.cpp +++ b/tests/library/util-floorwrap-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file util-floorwrap-test.cpp - ** unit test §§TODO§§ + ** unit test \ref UtilFloorwrap_test */ diff --git a/tests/library/util-foreach-test.cpp b/tests/library/util-foreach-test.cpp index e2dbfa276..5be9fc175 100644 --- a/tests/library/util-foreach-test.cpp +++ b/tests/library/util-foreach-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file util-foreach-test.cpp - ** unit test §§TODO§§ + ** unit test \ref UtilForeach_test */ diff --git a/tests/library/variant-test.cpp b/tests/library/variant-test.cpp index 12a180652..7340efc67 100644 --- a/tests/library/variant-test.cpp +++ b/tests/library/variant-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file variant-test.cpp - ** unit test §§TODO§§ + ** unit test \ref Variant_test */ diff --git a/tests/library/vector-transfer-test.cpp b/tests/library/vector-transfer-test.cpp index e9d33d5ce..d46dc81fe 100644 --- a/tests/library/vector-transfer-test.cpp +++ b/tests/library/vector-transfer-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file vector-transfer-test.cpp - ** unit test §§TODO§§ + ** unit test \ref VectorTransfer_test */ diff --git a/tests/library/verb-function-dispatch-test.cpp b/tests/library/verb-function-dispatch-test.cpp index 6dcc3eead..bed17b0ad 100644 --- a/tests/library/verb-function-dispatch-test.cpp +++ b/tests/library/verb-function-dispatch-test.cpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file verb-function-dispatch-test.cpp - ** unit test §§TODO§§ + ** unit test \ref VerbFunctionDispatch_test */ diff --git a/tests/operation/bugs/hello-bug-test.cpp b/tests/operation/bugs/hello-bug-test.cpp index 325462893..a637143ce 100644 --- a/tests/operation/bugs/hello-bug-test.cpp +++ b/tests/operation/bugs/hello-bug-test.cpp @@ -1,5 +1,5 @@ /* - HelloBug(test) - placeholder for running bug regression tests + HelloBug(Test) - placeholder for running bug regression tests Copyright (C) Lumiera.org 2008, Christian Thaeter @@ -21,7 +21,7 @@ * *****************************************************/ /** @file hello-bug-test.cpp - ** unit test §§TODO§§ + ** unit test \ref HelloBug_test */ From b4e0f6bf4075bcc6d63fae90d99b1da3a68824b3 Mon Sep 17 00:00:00 2001 From: Ichthyostega Date: Wed, 22 Feb 2017 03:46:23 +0100 Subject: [PATCH 26/26] Doxygen: fill in the last missing file level comments for plain-C tests now each and every source file should be marked with a @file doxygen comment --- tests/backend/test-filedescriptors.c | 7 ++++--- tests/backend/test-filehandles.c | 5 +++-- tests/backend/test-fileheader.c | 5 +++-- tests/backend/test-filemmap.c | 7 ++++--- tests/backend/test-resourcecollector.c | 5 +++-- tests/backend/test-threadpool.c | 4 ++-- tests/backend/test-threads.c | 8 ++++++-- tests/core/application/test-configloader.c | 5 +++-- tests/core/application/test-interfaces.c | 6 ++++-- tests/library/c-lib/test-errorstate.c | 6 ++++-- tests/library/c-lib/test-llist.c | 5 +++-- tests/library/c-lib/test-locking.c | 8 ++++++-- tests/library/c-lib/test-luid.c | 6 ++++-- tests/library/c-lib/test-mpool.c | 7 +++++-- tests/library/c-lib/test-priqueue.c | 5 +++-- tests/library/c-lib/test-psplay.c | 7 +++++-- tests/library/c-lib/test-safeclib.c | 5 +++-- tests/library/c-lib/test-slist.c | 4 ++-- tests/library/c-lib/test-time.c | 7 +++++-- tests/library/meta/dummy-functions.hpp | 2 +- 20 files changed, 73 insertions(+), 41 deletions(-) diff --git a/tests/backend/test-filedescriptors.c b/tests/backend/test-filedescriptors.c index 4b0cc7136..904228dac 100644 --- a/tests/backend/test-filedescriptors.c +++ b/tests/backend/test-filedescriptors.c @@ -1,5 +1,5 @@ /* - TEST-FILEDESCRIPTORS + TEST-FILEDESCRIPTORS - verify filedescriptor management Copyright (C) Lumiera.org 2008, Christian Thaeter @@ -20,8 +20,9 @@ * *****************************************************/ -/** @file §§§ - ** unit test §§TODO§§ +/** @file test-filedescriptors.c + ** C unit test to cover filedescriptor management + ** @see filedescriptor.h */ diff --git a/tests/backend/test-filehandles.c b/tests/backend/test-filehandles.c index 3040881f3..83da58793 100644 --- a/tests/backend/test-filehandles.c +++ b/tests/backend/test-filehandles.c @@ -20,8 +20,9 @@ * *****************************************************/ -/** @file §§§ - ** unit test §§TODO§§ +/** @file test-filehandles.c + ** C unit test to cover management for filehandles and the filehandle cache + ** @see filehandlecache.h */ diff --git a/tests/backend/test-fileheader.c b/tests/backend/test-fileheader.c index 84045fef8..70985b67c 100644 --- a/tests/backend/test-fileheader.c +++ b/tests/backend/test-fileheader.c @@ -20,8 +20,9 @@ * *****************************************************/ -/** @file §§§ - ** unit test §§TODO§§ +/** @file test-fileheader.c + ** C unit test to verify file identification functions + ** @see fileheader.h */ diff --git a/tests/backend/test-filemmap.c b/tests/backend/test-filemmap.c index dd1219f9b..4a2159ec1 100644 --- a/tests/backend/test-filemmap.c +++ b/tests/backend/test-filemmap.c @@ -1,5 +1,5 @@ /* - TEST-FILEMAP - test file management + TEST-FILEMAP - test file memory mapping Copyright (C) Lumiera.org 2008, Christian Thaeter @@ -20,8 +20,9 @@ * *****************************************************/ -/** @file §§§ - ** unit test §§TODO§§ +/** @file test-filemmap.c + ** C unit test to cover memory mapping of file contents + ** @see mmapings.h */ diff --git a/tests/backend/test-resourcecollector.c b/tests/backend/test-resourcecollector.c index 267dab37c..b55ec115f 100644 --- a/tests/backend/test-resourcecollector.c +++ b/tests/backend/test-resourcecollector.c @@ -20,8 +20,9 @@ * *****************************************************/ -/** @file §§§ - ** unit test §§TODO§§ +/** @file test-resourcecollector.c + ** C unit test to cover management of low-level resources for the backend + ** @see resourcecollector.h */ diff --git a/tests/backend/test-threadpool.c b/tests/backend/test-threadpool.c index 3c79f7e6c..9320b94c5 100644 --- a/tests/backend/test-threadpool.c +++ b/tests/backend/test-threadpool.c @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test §§TODO§§ +/** @file test-threadpool.c + ** C unit test to cover our threadpool implementation */ diff --git a/tests/backend/test-threads.c b/tests/backend/test-threads.c index 64a388a1e..395680d0e 100644 --- a/tests/backend/test-threads.c +++ b/tests/backend/test-threads.c @@ -20,8 +20,12 @@ * *****************************************************/ -/** @file §§§ - ** unit test §§TODO§§ +/** @file test-threads.c + ** C unit test to cover thread handling helpers + ** Especially, we rely on a specific setup for threads, which allows + ** to manage worker threads in a threadpool + ** @see threads.h + ** @see test-threadpool.c */ diff --git a/tests/core/application/test-configloader.c b/tests/core/application/test-configloader.c index e9ab6a21b..bfd75a7e7 100644 --- a/tests/core/application/test-configloader.c +++ b/tests/core/application/test-configloader.c @@ -21,8 +21,9 @@ * *****************************************************/ -/** @file §§§ - ** unit test §§TODO§§ +/** @file test-configloader.c + ** C unit test to cover a config system draft implementation + ** @deprecated as of 2017 it is very likely we'll use a different approach */ diff --git a/tests/core/application/test-interfaces.c b/tests/core/application/test-interfaces.c index 1acfc51f3..bbae36bf5 100644 --- a/tests/core/application/test-interfaces.c +++ b/tests/core/application/test-interfaces.c @@ -20,8 +20,10 @@ * *****************************************************/ -/** @file §§§ - ** unit test §§TODO§§ +/** @file test-interfaces.c + ** C unit test to cover the basics of our interface and plugin-loading system + ** @see interface.h + ** @see interfaceregistry.h */ diff --git a/tests/library/c-lib/test-errorstate.c b/tests/library/c-lib/test-errorstate.c index 080a4bdf0..16e83af11 100644 --- a/tests/library/c-lib/test-errorstate.c +++ b/tests/library/c-lib/test-errorstate.c @@ -20,8 +20,10 @@ * *****************************************************/ -/** @file §§§ - ** unit test §§TODO§§ +/** @file test-errorstate.c + ** C unit test to cover basic error handling in C code + ** We manage an _errorstate variable_ in thread local storage, + ** which allows to set an global error state per thread. */ diff --git a/tests/library/c-lib/test-llist.c b/tests/library/c-lib/test-llist.c index 2d1b5ceca..e97af241f 100644 --- a/tests/library/c-lib/test-llist.c +++ b/tests/library/c-lib/test-llist.c @@ -20,8 +20,9 @@ * *****************************************************/ -/** @file §§§ - ** unit test §§TODO§§ +/** @file test-llist.c + ** C unit test to cover a linked list library implementation + ** @see llist.h */ diff --git a/tests/library/c-lib/test-locking.c b/tests/library/c-lib/test-locking.c index f2601db22..7703a6a8f 100644 --- a/tests/library/c-lib/test-locking.c +++ b/tests/library/c-lib/test-locking.c @@ -20,8 +20,12 @@ * *****************************************************/ -/** @file §§§ - ** unit test §§TODO§§ +/** @file test-locking.c + ** C unit test to cover convenience setup for POSIX locking primitives + ** These convenience macros are intended for use in low-level C code, + ** where minimal and precise locking is relevant for performance reasons. + ** @see mutex.h + ** @see condition.h */ diff --git a/tests/library/c-lib/test-luid.c b/tests/library/c-lib/test-luid.c index 01f26eef5..d49ebc68c 100644 --- a/tests/library/c-lib/test-luid.c +++ b/tests/library/c-lib/test-luid.c @@ -20,8 +20,10 @@ * *****************************************************/ -/** @file §§§ - ** unit test §§TODO§§ +/** @file test-luid.c + ** C unit test to cover generation of Lumiera Uniform Identifier hashes + ** @see luid.h + ** @see hash-indexed.hpp */ diff --git a/tests/library/c-lib/test-mpool.c b/tests/library/c-lib/test-mpool.c index a15e864a0..231c16955 100644 --- a/tests/library/c-lib/test-mpool.c +++ b/tests/library/c-lib/test-mpool.c @@ -20,8 +20,11 @@ * *****************************************************/ -/** @file §§§ - ** unit test §§TODO§§ +/** @file test-mpool.c + ** C unit test to cover a memory pool custom allocator + ** + ** @warning unfinished implementation as of 2016 + ** @see mpool.h */ diff --git a/tests/library/c-lib/test-priqueue.c b/tests/library/c-lib/test-priqueue.c index b5c25e1b8..ff3c86510 100644 --- a/tests/library/c-lib/test-priqueue.c +++ b/tests/library/c-lib/test-priqueue.c @@ -20,8 +20,9 @@ * *****************************************************/ -/** @file §§§ - ** unit test §§TODO§§ +/** @file test-priqueue.c + ** C unit test to cover a priority queue library implementation + ** @see priqueue.h */ diff --git a/tests/library/c-lib/test-psplay.c b/tests/library/c-lib/test-psplay.c index e8effdb19..fd9760f6b 100644 --- a/tests/library/c-lib/test-psplay.c +++ b/tests/library/c-lib/test-psplay.c @@ -20,8 +20,11 @@ * *****************************************************/ -/** @file §§§ - ** unit test §§TODO§§ +/** @file test-psplay.c + ** C unit test to cover a probabilistic splay tree library implementation. + ** These tree data structures are used as key-value store in several of the + ** management facilities of the backend + ** @see psplay.h */ diff --git a/tests/library/c-lib/test-safeclib.c b/tests/library/c-lib/test-safeclib.c index 6de98c184..c0f80d10f 100644 --- a/tests/library/c-lib/test-safeclib.c +++ b/tests/library/c-lib/test-safeclib.c @@ -20,8 +20,9 @@ * *****************************************************/ -/** @file §§§ - ** unit test §§TODO§§ +/** @file test-safeclib.c + ** C unit test to cover size checked C operations + ** @see safeclib.h */ diff --git a/tests/library/c-lib/test-slist.c b/tests/library/c-lib/test-slist.c index 296a3ca8b..4d34f9fd4 100644 --- a/tests/library/c-lib/test-slist.c +++ b/tests/library/c-lib/test-slist.c @@ -20,8 +20,8 @@ * *****************************************************/ -/** @file §§§ - ** unit test §§TODO§§ +/** @file test-slist.c + ** C unit test to cover a single linked list library implementation */ diff --git a/tests/library/c-lib/test-time.c b/tests/library/c-lib/test-time.c index ac31b798c..09f3e4589 100644 --- a/tests/library/c-lib/test-time.c +++ b/tests/library/c-lib/test-time.c @@ -20,8 +20,11 @@ * *****************************************************/ -/** @file §§§ - ** unit test §§TODO§§ +/** @file test-time.c + ** C unit test to cover the basic low-level time handling operations + ** @see time.h + ** @see timevalue.hpp + ** @see TimeValue_test high-level time entities */ diff --git a/tests/library/meta/dummy-functions.hpp b/tests/library/meta/dummy-functions.hpp index 7cf523e4d..0b776236e 100644 --- a/tests/library/meta/dummy-functions.hpp +++ b/tests/library/meta/dummy-functions.hpp @@ -21,7 +21,7 @@ * *****************************************************/ /** @file dummy-functions.hpp - ** unit test §§TODO§§ + ** dummy functions to support unit testing of function metaprogramming helpers */