[causeway] 01/05: CAUSEWAY-3395: removes TODO pertaining to CommandExecutorService

[da...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

danhaywood pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/causeway.git

commit 8fe92822c3eadbf1d869dae1383e2245bc03f7ec
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Sat Jun 17 12:31:28 2023 +0100

    CAUSEWAY-3395: removes TODO pertaining to CommandExecutorService
---
 .../hooks/CommandExecutorService_020-examples-and-usage.adoc | 12 +++---------
 1 file changed, 3 insertions(+), 9 deletions(-)

diff --git a/antora/components/refguide-index/modules/applib/pages/index/services/command/hooks/CommandExecutorService_020-examples-and-usage.adoc b/antora/components/refguide-index/modules/applib/pages/index/services/command/hooks/CommandExecutorService_020-examples-and-usage.adoc
index 408e6f207c..21442f7e8a 100644
--- a/antora/components/refguide-index/modules/applib/pages/index/services/command/hooks/CommandExecutorService_020-examples-and-usage.adoc
+++ b/antora/components/refguide-index/modules/applib/pages/index/services/command/hooks/CommandExecutorService_020-examples-and-usage.adoc
@@ -5,14 +5,8 @@
 
 == Usage
 
-The `CommandExecutorService` domain service is provides the ability to execute a specified xref:refguide:applib:index/services/command/Command.adoc[Command], optionally running the command with the identity of the user captured in that xref:refguide:applib:index/services/command/Command.adoc[Command].
+The  `CommandExecutorService` domain service is provides the ability to execute a specified xref:refguide:applib:index/services/command/Command.adoc[Command], optionally running the command with the identity of the user captured in that xref:refguide:applib:index/services/command/Command.adoc[Command].
 
+One use case is the xref:refguide:extensions:index/commandlog/applib/job/RunBackgroundCommandsJob.adoc[] provided by xref:userguide:commandlog:about.adoc[Command Log] extension.
+This picks up commands persisted as "background" xref:refguide:extensions:index/commandlog/applib/dom/CommandLogEntry.adoc[]s, and executes them against their target domain object.
 
-// TODO - v2 this is out of date; reference the commandreplay service, now part of framework.
-
-//In fact, the service requires that the implementation of the xref:refguide:applib:index/services/command/Command.adoc[Command] being executed implements the `CommandWithDto` sub-interface.
-//This allows the xref:refguide:schema:cmd.adoc[CommandDto] memento to be extracted, from which the action can be invoked/property edited.
-//
-//The primary use case for this service is to allow the replay of commands, eg for regression testing.
-//This is implemented by the (non-ASF) link:https://platform.incode.org/modules/spi/command/spi-commandreplay.html[command replay module].
-//(The command replay module also provides a decorator implementation of this service that allows the command to be re-executed at the same _time_ as the original command, leveraging the `TickingClock` implementation provided by the framework).