You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by ah...@apache.org on 2020/12/13 15:21:34 UTC

[isis] branch master updated: ISIS-2473: re-gen doc index again

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

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


The following commit(s) were added to refs/heads/master by this push:
     new 321d891  ISIS-2473: re-gen doc index again
321d891 is described below

commit 321d891cc0fb24f4abefd82e37ea43f17b94dbc8
Author: Andi Huber <ah...@apache.org>
AuthorDate: Sun Dec 13 16:21:24 2020 +0100

    ISIS-2473: re-gen doc index again
---
 .../pages/index/applib/ApplicationException.adoc   |  2 +-
 .../pages/index/applib/FatalException.adoc         |  2 +-
 .../generated/pages/index/applib/Identifier.adoc   |  2 +-
 .../index/applib/NonRecoverableException.adoc      |  2 +-
 .../pages/index/applib/PersistFailedException.adoc |  2 +-
 .../pages/index/applib/RecoverableException.adoc   |  2 +-
 .../pages/index/applib/RepositoryException.adoc    |  2 +-
 .../generated/pages/index/applib/ViewModel.adoc    |  2 +-
 .../pages/index/applib/adapters/Parser.adoc        |  2 +-
 .../applib/adapters/ValueSemanticsProvider.adoc    | 14 ++++-----
 .../pages/index/applib/annotation/Action.adoc      | 20 ++++++-------
 .../index/applib/annotation/ActionLayout.adoc      |  8 ++---
 .../pages/index/applib/annotation/Collection.adoc  |  4 +--
 .../index/applib/annotation/CollectionLayout.adoc  |  2 +-
 .../pages/index/applib/annotation/Defaulted.adoc   |  8 ++---
 .../index/applib/annotation/DomainObject.adoc      | 14 ++++-----
 .../applib/annotation/DomainObjectLayout.adoc      |  8 ++---
 .../index/applib/annotation/DomainService.adoc     |  2 +-
 .../pages/index/applib/annotation/Nature.adoc      |  4 +--
 .../pages/index/applib/annotation/Parameter.adoc   |  4 +--
 .../index/applib/annotation/ParameterLayout.adoc   |  4 +--
 .../pages/index/applib/annotation/Property.adoc    | 24 +++++++--------
 .../index/applib/annotation/PropertyLayout.adoc    | 14 ++++-----
 .../pages/index/applib/annotation/Publishing.adoc  |  8 ++---
 .../pages/index/applib/annotation/Title.adoc       |  2 +-
 .../pages/index/applib/annotation/Value.adoc       | 10 +++----
 .../pages/index/applib/annotation/Where.adoc       |  2 +-
 .../pages/index/applib/clock/VirtualClock.adoc     | 10 +++----
 .../applib/events/domain/AbstractDomainEvent.adoc  | 10 +++----
 .../applib/events/domain/ActionDomainEvent.adoc    |  2 +-
 .../pages/index/applib/events/ui/TitleUiEvent.adoc |  2 +-
 .../pages/index/applib/graph/tree/TreeNode.adoc    |  8 ++---
 .../pages/index/applib/graph/tree/TreePath.adoc    |  4 +--
 .../generated/pages/index/applib/query/Query.adoc  |  2 +-
 .../index/applib/query/QueryFindAllInstances.adoc  |  2 +-
 .../index/applib/services/DomainChangeRecord.adoc  |  4 +--
 .../RepresentsInteractionMemberExecution.adoc      |  2 +-
 .../index/applib/services/bookmark/Bookmark.adoc   |  4 +--
 .../applib/services/bookmark/BookmarkService.adoc  | 18 ++++++------
 .../index/applib/services/command/Command.adoc     | 10 +++----
 .../services/command/CommandExecutorService.adoc   |  2 +-
 .../ContentMappingServiceForCommandsDto.adoc       |  2 +-
 .../processor/spi/CommandDtoProcessorService.adoc  |  2 +-
 .../confview/ConfigurationViewService.adoc         |  4 +--
 .../index/applib/services/error/ErrorDetails.adoc  |  2 +-
 .../pages/index/applib/services/error/Ticket.adoc  |  2 +-
 .../services/exceprecog/ExceptionRecognizer.adoc   |  2 +-
 .../exceprecog/ExceptionRecognizerService.adoc     |  4 +--
 .../services/exceprecog/TranslatableException.adoc |  2 +-
 .../index/applib/services/grid/GridService.adoc    |  8 ++---
 .../services/homepage/HomePageResolverService.adoc |  2 +-
 .../applib/services/i18n/TranslatableString.adoc   |  6 ++--
 .../applib/services/iactn/ExecutionContext.adoc    |  4 +--
 .../index/applib/services/iactn/Interaction.adoc   |  6 ++--
 .../applib/services/iactn/InteractionContext.adoc  |  6 ++--
 .../applib/services/layout/LayoutService.adoc      |  2 +-
 .../applib/services/message/MessageService.adoc    | 12 ++++----
 .../services/metamodel/MetaModelService.adoc       |  4 +--
 .../services/publishing/spi/CommandSubscriber.adoc |  4 +--
 .../publishing/spi/EntityChangesSubscriber.adoc    |  2 +-
 .../publishing/spi/EntityPropertyChange.adoc       |  2 +-
 .../spi/EntityPropertyChangeSubscriber.adoc        |  2 +-
 .../services/repository/RepositoryService.adoc     | 10 +++----
 .../index/applib/services/sudo/SudoService.adoc    | 12 ++++----
 .../index/applib/services/user/RoleMemento.adoc    |  2 +-
 .../index/applib/services/user/UserMemento.adoc    | 12 ++++----
 .../index/applib/services/user/UserService.adoc    | 14 ++++-----
 .../services/userreg/UserRegistrationService.adoc  |  2 +-
 .../applib/services/wrapper/WrapperFactory.adoc    | 26 ++++++++---------
 .../applib/services/wrapper/WrappingObject.adoc    |  4 +--
 .../services/wrapper/control/ControlAbstract.adoc  |  2 +-
 .../services/wrapper/control/SyncControl.adoc      |  2 +-
 .../wrapper/events/ActionArgumentEvent.adoc        |  2 +-
 .../wrapper/events/ActionInvocationEvent.adoc      |  4 +--
 .../wrapper/events/ActionVisibilityEvent.adoc      |  2 +-
 .../wrapper/events/CollectionAccessEvent.adoc      |  2 +-
 .../services/wrapper/events/InteractionEvent.adoc  | 12 ++++----
 .../wrapper/events/PropertyAccessEvent.adoc        |  2 +-
 .../wrapper/events/ProposedHolderEvent.adoc        |  2 +-
 .../services/wrapper/events/VisibilityEvent.adoc   |  2 +-
 .../wrapper/listeners/InteractionAdapter.adoc      |  2 +-
 .../wrapper/listeners/InteractionListener.adoc     | 34 +++++++++++-----------
 .../applib/services/xactn/TransactionService.adoc  |  4 +--
 .../snapshot/SnapshottableWithInclusions.adoc      |  2 +-
 .../index/applib/spec/AbstractSpecification.adoc   |  2 +-
 .../index/applib/spec/AbstractSpecification2.adoc  |  4 +--
 .../pages/index/applib/spec/Specification2.adoc    |  8 ++---
 .../pages/index/applib/spec/SpecificationAnd.adoc  |  4 +--
 .../pages/index/applib/spec/SpecificationNot.adoc  |  4 +--
 .../pages/index/applib/spec/SpecificationOr.adoc   |  4 +--
 .../generated/pages/index/applib/value/Blob.adoc   |  8 ++---
 .../generated/pages/index/applib/value/Clob.adoc   |  8 ++---
 .../generated/pages/index/applib/value/Markup.adoc |  2 +-
 .../modules/generated/pages/system-overview.adoc   |  8 ++---
 94 files changed, 269 insertions(+), 269 deletions(-)

diff --git a/antora/components/system/modules/generated/pages/index/applib/ApplicationException.adoc b/antora/components/system/modules/generated/pages/index/applib/ApplicationException.adoc
index b43f8b9..96e8e35 100644
--- a/antora/components/system/modules/generated/pages/index/applib/ApplicationException.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/ApplicationException.adoc
@@ -9,7 +9,7 @@ This exception should only be thrown for "recoverable" exceptions, that is, thos
 
 The framework attempts to apply some heuristics; if the underlying Isis transaction has been aborted (for example as the result of a problem persisting some data) but then the application attempts to throw this exception, the exception will be promoted to a fatal exception.
 
-Note that this exception has identical semantics to xref:system:generated:index/applib/RecoverableException.adoc.adoc[RecoverableException] , and can be considered a synonym.
+Note that this exception has identical semantics to xref:system:generated:index/applib/RecoverableException.adoc[RecoverableException] , and can be considered a synonym.
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/FatalException.adoc b/antora/components/system/modules/generated/pages/index/applib/FatalException.adoc
index 0d80e2f..84b5fe7 100644
--- a/antora/components/system/modules/generated/pages/index/applib/FatalException.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/FatalException.adoc
@@ -5,7 +5,7 @@ Indicates that an unexpected, non-recoverable (fatal) exception has occurred wit
 
 Throwing this exception will (dependent on the viewer) result in some sort of an error page being displayed to the user.
 
-Note that this exception has identical semantics to xref:system:generated:index/applib/NonRecoverableException.adoc.adoc[NonRecoverableException] , and can be considered a synonym.
+Note that this exception has identical semantics to xref:system:generated:index/applib/NonRecoverableException.adoc[NonRecoverableException] , and can be considered a synonym.
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/Identifier.adoc b/antora/components/system/modules/generated/pages/index/applib/Identifier.adoc
index 113379a..010914d 100644
--- a/antora/components/system/modules/generated/pages/index/applib/Identifier.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/Identifier.adoc
@@ -94,7 +94,7 @@ Convenience method.
 --
 REVIEW: why not just compare the _#toString()_ representations?
 --
-<.> `[teal]#*_fromIdentityString_*#(String asString)` : `xref:system:generated:index/applib/Identifier.adoc.adoc[Identifier]`
+<.> `[teal]#*_fromIdentityString_*#(String asString)` : `xref:system:generated:index/applib/Identifier.adoc[Identifier]`
 +
 --
 Factory method.
diff --git a/antora/components/system/modules/generated/pages/index/applib/NonRecoverableException.adoc b/antora/components/system/modules/generated/pages/index/applib/NonRecoverableException.adoc
index 9cdd906..c340433 100644
--- a/antora/components/system/modules/generated/pages/index/applib/NonRecoverableException.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/NonRecoverableException.adoc
@@ -5,7 +5,7 @@ Indicates that an unexpected, non-recoverable (fatal) exception has occurred wit
 
 Throwing this exception will (dependent on the viewer) result in some sort of an error page being displayed to the user.
 
-Note that this exception has identical semantics to xref:system:generated:index/applib/FatalException.adoc.adoc[FatalException] (of which it is the immediate superclass) and can be considered a synonym.
+Note that this exception has identical semantics to xref:system:generated:index/applib/FatalException.adoc[FatalException] (of which it is the immediate superclass) and can be considered a synonym.
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/PersistFailedException.adoc b/antora/components/system/modules/generated/pages/index/applib/PersistFailedException.adoc
index f94d079..be08a3a 100644
--- a/antora/components/system/modules/generated/pages/index/applib/PersistFailedException.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/PersistFailedException.adoc
@@ -3,7 +3,7 @@
 
 Indicates that the persistence of an object failed.
 
-This exception is intended to represent an unexpected and non-recoverable condition (eg a unique/primary key/ foreign key constaint has been violated), and so is a subclass of xref:system:generated:index/applib/NonRecoverableException.adoc.adoc[NonRecoverableException] . Throwing this exception will therefore result in (some sort of) error page being displayed to the user.
+This exception is intended to represent an unexpected and non-recoverable condition (eg a unique/primary key/ foreign key constaint has been violated), and so is a subclass of xref:system:generated:index/applib/NonRecoverableException.adoc[NonRecoverableException] . Throwing this exception will therefore result in (some sort of) error page being displayed to the user.
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/RecoverableException.adoc b/antora/components/system/modules/generated/pages/index/applib/RecoverableException.adoc
index 3872662..cf986e0 100644
--- a/antora/components/system/modules/generated/pages/index/applib/RecoverableException.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/RecoverableException.adoc
@@ -9,7 +9,7 @@ This exception should only be thrown for "recoverable" exceptions, that is, thos
 
 The framework attempts to apply some heuristics; if the underlying Isis transaction has been aborted (for example as the result of a problem persisting some data) but then the application attempts to throw this exception, the exception will be promoted to a fatal exception.
 
-Note that this exception has identical semantics to xref:system:generated:index/applib/ApplicationException.adoc.adoc[ApplicationException] (of which it is the immediate superclass), and can be considered a synonym.
+Note that this exception has identical semantics to xref:system:generated:index/applib/ApplicationException.adoc[ApplicationException] (of which it is the immediate superclass), and can be considered a synonym.
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/RepositoryException.adoc b/antora/components/system/modules/generated/pages/index/applib/RepositoryException.adoc
index 1aef372..431f428 100644
--- a/antora/components/system/modules/generated/pages/index/applib/RepositoryException.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/RepositoryException.adoc
@@ -3,7 +3,7 @@
 
 Indicates that a repository method has failed.
 
-This exception is intended to represent an unexpected and non-recoverable condition (eg a syntax error in some JDOQL query syntax or similar), and so is a subclass of xref:system:generated:index/applib/NonRecoverableException.adoc.adoc[NonRecoverableException] . Throwing this exception will therefore result in (some sort of) error page being displayed to the user.
+This exception is intended to represent an unexpected and non-recoverable condition (eg a syntax error in some JDOQL query syntax or similar), and so is a subclass of xref:system:generated:index/applib/NonRecoverableException.adoc[NonRecoverableException] . Throwing this exception will therefore result in (some sort of) error page being displayed to the user.
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/ViewModel.adoc b/antora/components/system/modules/generated/pages/index/applib/ViewModel.adoc
index 1b1d96d..b58c457 100644
--- a/antora/components/system/modules/generated/pages/index/applib/ViewModel.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/ViewModel.adoc
@@ -3,7 +3,7 @@
 
 Indicates that an object belongs to the UI/application layer, and is intended to be used as a view model.
 
-Objects that are part of the domain object layer should instead implement xref:system:generated:index/applib/RecreatableDomainObject.adoc.adoc[RecreatableDomainObject] .
+Objects that are part of the domain object layer should instead implement xref:system:generated:index/applib/RecreatableDomainObject.adoc[RecreatableDomainObject] .
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/adapters/Parser.adoc b/antora/components/system/modules/generated/pages/index/applib/adapters/Parser.adoc
index 6e7e406..5e41fcf 100644
--- a/antora/components/system/modules/generated/pages/index/applib/adapters/Parser.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/adapters/Parser.adoc
@@ -9,7 +9,7 @@ Specifically, this interface embodies three related capabilities:
 * to provide a string representation of the object, for use as its title.
 * to indicate the typical length of such a string representation.
 
-For custom-written (as opposed to third-party) value types, the ability for the xref:system:generated:index/applib/adapters/Parser.adoc.adoc[Parser] to provide a title responsibilities overlap with other conventions for domain objects. Specifically, normally we write a `title()` method to return a title. In such cases a typical implementation of xref:system:generated:index/applib/adapters/Parser.adoc.adoc[Parser] would just delegate to the value type itself to obtain the title (ie invoki [...]
+For custom-written (as opposed to third-party) value types, the ability for the xref:system:generated:index/applib/adapters/Parser.adoc[Parser] to provide a title responsibilities overlap with other conventions for domain objects. Specifically, normally we write a `title()` method to return a title. In such cases a typical implementation of xref:system:generated:index/applib/adapters/Parser.adoc[Parser] would just delegate to the value type itself to obtain the title (ie invoking the `ti [...]
 
 Similarly, the ability to return a typical length also overlaps with the _TypicalLength_ annotation; which is why _TypicalLength_ cannot be applied to types, only to properties and parameters.
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/adapters/ValueSemanticsProvider.adoc b/antora/components/system/modules/generated/pages/index/applib/adapters/ValueSemanticsProvider.adoc
index 0206c49..04af079 100644
--- a/antora/components/system/modules/generated/pages/index/applib/adapters/ValueSemanticsProvider.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/adapters/ValueSemanticsProvider.adoc
@@ -3,7 +3,7 @@
 
 Provides a mechanism for providing a set of value semantics.
 
-This interface is used by xref:system:generated:index/applib/annotation/Value.adoc.adoc[Value] to allow these semantics to be provided through a single point. Alternatively, xref:system:generated:index/applib/annotation/Value.adoc.adoc[Value] supports this information being provided via the configuration files.
+This interface is used by xref:system:generated:index/applib/annotation/Value.adoc[Value] to allow these semantics to be provided through a single point. Alternatively, xref:system:generated:index/applib/annotation/Value.adoc[Value] supports this information being provided via the configuration files.
 
 Whatever the class that implements this interface, it must also expose either a `public` no-arg constructor, or (for implementations that also are `Facet` s) a `public` constructor that accepts a `FacetHolder` , and `IsisConfiguration` and a `ValueSemanticsProviderContext` . This constructor is then used by the framework to instantiate the object reflectively.
 
@@ -20,20 +20,20 @@ interface ValueSemanticsProvider {
 }
 ----
 
-<.> `[teal]#*getParser*#()` : `xref:system:generated:index/applib/adapters/Parser.adoc.adoc[Parser]<T>`
+<.> `[teal]#*getParser*#()` : `xref:system:generated:index/applib/adapters/Parser.adoc[Parser]<T>`
 +
 --
-The xref:system:generated:index/applib/adapters/Parser.adoc.adoc[Parser] , if any.
+The xref:system:generated:index/applib/adapters/Parser.adoc[Parser] , if any.
 --
-<.> `[teal]#*getEncoderDecoder*#()` : `xref:system:generated:index/applib/adapters/EncoderDecoder.adoc.adoc[EncoderDecoder]<T>`
+<.> `[teal]#*getEncoderDecoder*#()` : `xref:system:generated:index/applib/adapters/EncoderDecoder.adoc[EncoderDecoder]<T>`
 +
 --
-The xref:system:generated:index/applib/adapters/EncoderDecoder.adoc.adoc[EncoderDecoder] , if any.
+The xref:system:generated:index/applib/adapters/EncoderDecoder.adoc[EncoderDecoder] , if any.
 --
-<.> `[teal]#*getDefaultsProvider*#()` : `xref:system:generated:index/applib/adapters/DefaultsProvider.adoc.adoc[DefaultsProvider]<T>`
+<.> `[teal]#*getDefaultsProvider*#()` : `xref:system:generated:index/applib/adapters/DefaultsProvider.adoc[DefaultsProvider]<T>`
 +
 --
-The xref:system:generated:index/applib/adapters/DefaultsProvider.adoc.adoc[DefaultsProvider] , if any.
+The xref:system:generated:index/applib/adapters/DefaultsProvider.adoc[DefaultsProvider] , if any.
 
 If not `null` , implies that the value has (or may have) a default.
 --
diff --git a/antora/components/system/modules/generated/pages/index/applib/annotation/Action.adoc b/antora/components/system/modules/generated/pages/index/applib/annotation/Action.adoc
index bc41b5a..5e30591 100644
--- a/antora/components/system/modules/generated/pages/index/applib/annotation/Action.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/annotation/Action.adoc
@@ -55,14 +55,14 @@ For example@Action(associateWith="items", associateWithSequence="2.1")
 <.> `[teal]#*_commandDtoProcessor_*#` : `Class<? extends CommandDtoProcessor>`
 +
 --
-The xref:system:generated:index/applib/services/commanddto/processor/CommandDtoProcessor.adoc.adoc[CommandDtoProcessor] to process this command's DTO.
+The xref:system:generated:index/applib/services/commanddto/processor/CommandDtoProcessor.adoc[CommandDtoProcessor] to process this command's DTO.
 
-The processor itself is used by xref:system:generated:index/applib/services/commanddto/conmap/ContentMappingServiceForCommandDto.adoc.adoc[ContentMappingServiceForCommandDto] and xref:system:generated:index/applib/services/commanddto/conmap/ContentMappingServiceForCommandsDto.adoc.adoc[ContentMappingServiceForCommandsDto] to dynamically transform the DTOs.
+The processor itself is used by xref:system:generated:index/applib/services/commanddto/conmap/ContentMappingServiceForCommandDto.adoc[ContentMappingServiceForCommandDto] and xref:system:generated:index/applib/services/commanddto/conmap/ContentMappingServiceForCommandsDto.adoc[ContentMappingServiceForCommandsDto] to dynamically transform the DTOs.
 --
-<.> `[teal]#*_commandPublishing_*#` : `xref:system:generated:index/applib/annotation/Publishing.adoc.adoc[Publishing]`
+<.> `[teal]#*_commandPublishing_*#` : `xref:system:generated:index/applib/annotation/Publishing.adoc[Publishing]`
 +
 --
-Whether action invocations, captured as xref:system:generated:index/applib/services/command/Command.adoc.adoc[Command] s, should be published to xref:system:generated:index/applib/services/publishing/spi/CommandSubscriber.adoc.adoc[CommandSubscriber] s.
+Whether action invocations, captured as xref:system:generated:index/applib/services/command/Command.adoc[Command] s, should be published to xref:system:generated:index/applib/services/publishing/spi/CommandSubscriber.adoc[CommandSubscriber] s.
 --
 <.> `[teal]#*_domainEvent_*#` : `Class<? extends ActionDomainEvent<?>>`
 +
@@ -84,12 +84,12 @@ public class SomeObject{
 
 This subclass must provide a no-arg constructor; the fields are set reflectively.
 --
-<.> `[teal]#*_executionPublishing_*#` : `xref:system:generated:index/applib/annotation/Publishing.adoc.adoc[Publishing]`
+<.> `[teal]#*_executionPublishing_*#` : `xref:system:generated:index/applib/annotation/Publishing.adoc[Publishing]`
 +
 --
-Whether _Interaction.Execution_ s (triggered by action invocations), should be published to xref:system:generated:index/applib/services/publishing/spi/ExecutionSubscriber.adoc.adoc[ExecutionSubscriber] s.
+Whether _Interaction.Execution_ s (triggered by action invocations), should be published to xref:system:generated:index/applib/services/publishing/spi/ExecutionSubscriber.adoc[ExecutionSubscriber] s.
 --
-<.> `[teal]#*_hidden_*#` : `xref:system:generated:index/applib/annotation/Where.adoc.adoc[Where]`
+<.> `[teal]#*_hidden_*#` : `xref:system:generated:index/applib/annotation/Where.adoc[Where]`
 +
 --
 Indicates where (in the UI) the action is not visible to the user.
@@ -98,14 +98,14 @@ It is also possible to suppress an action's visibility using _ActionLayout#hidde
 
 For _DomainService domain service_ actions, the action's visibility is dependent upon its _DomainService#nature() nature_ and for contributed actions on how it is _ActionLayout#contributed()_ .
 --
-<.> `[teal]#*_restrictTo_*#` : `xref:system:generated:index/applib/annotation/RestrictTo.adoc.adoc[RestrictTo]`
+<.> `[teal]#*_restrictTo_*#` : `xref:system:generated:index/applib/annotation/RestrictTo.adoc[RestrictTo]`
 +
 --
 Whether the action is restricted to prototyping.
 
 By default there are no restrictions, with the action being available in all environments.
 --
-<.> `[teal]#*_semantics_*#` : `xref:system:generated:index/applib/annotation/SemanticsOf.adoc.adoc[SemanticsOf]`
+<.> `[teal]#*_semantics_*#` : `xref:system:generated:index/applib/annotation/SemanticsOf.adoc[SemanticsOf]`
 +
 --
 The action semantics, either _SemanticsOf#SAFE_AND_REQUEST_CACHEABLE cached_ , _SemanticsOf#SAFE safe_ (query-only), _SemanticsOf#IDEMPOTENT idempotent_ or _SemanticsOf#NON_IDEMPOTENT non-idempotent_ .
@@ -118,7 +118,7 @@ The type-of the elements returned by the action.
 <.> `[teal]#*_fileAccept_*#` : `String`
 +
 --
-For downloading xref:system:generated:index/applib/value/Blob.adoc.adoc[Blob] or xref:system:generated:index/applib/value/Clob.adoc.adoc[Clob] , optionally restrict the files accepted (eg `.xslx` ).
+For downloading xref:system:generated:index/applib/value/Blob.adoc[Blob] or xref:system:generated:index/applib/value/Clob.adoc[Clob] , optionally restrict the files accepted (eg `.xslx` ).
 
 The value should be of the form "file_extension|audio/*|video/*|image/*|media_type".
 --
diff --git a/antora/components/system/modules/generated/pages/index/applib/annotation/ActionLayout.adoc b/antora/components/system/modules/generated/pages/index/applib/annotation/ActionLayout.adoc
index 88e75d9..7fe77b5 100644
--- a/antora/components/system/modules/generated/pages/index/applib/annotation/ActionLayout.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/annotation/ActionLayout.adoc
@@ -30,7 +30,7 @@ Layout hints for actions.
 }
 ----
 
-<.> `[teal]#*_bookmarking_*#` : `xref:system:generated:index/applib/annotation/BookmarkPolicy.adoc.adoc[BookmarkPolicy]`
+<.> `[teal]#*_bookmarking_*#` : `xref:system:generated:index/applib/annotation/BookmarkPolicy.adoc[BookmarkPolicy]`
 +
 --
 Whether (and how) this action can be bookmarked in the UI.
@@ -59,7 +59,7 @@ Indicates the position of theFont Awesomeicon. The icon could be rendered on the
 --
 Description of this action, eg to be rendered in a tooltip.
 --
-<.> `[teal]#*_hidden_*#` : `xref:system:generated:index/applib/annotation/Where.adoc.adoc[Where]`
+<.> `[teal]#*_hidden_*#` : `xref:system:generated:index/applib/annotation/Where.adoc[Where]`
 +
 --
 Indicates where in the UI the action should _not_ not be visible.
@@ -76,12 +76,12 @@ For actions that are associated with a property, indicates the positioning of th
 
 Ignored if the action has not been associated with a property.
 --
-<.> `[teal]#*_promptStyle_*#` : `xref:system:generated:index/applib/annotation/PromptStyle.adoc.adoc[PromptStyle]`
+<.> `[teal]#*_promptStyle_*#` : `xref:system:generated:index/applib/annotation/PromptStyle.adoc[PromptStyle]`
 +
 --
 How this parameters for this action are prompted, either _PromptStyle#DIALOG dialog_ or _PromptStyle#INLINE inline_ .
 --
-<.> `[teal]#*_redirectPolicy_*#` : `xref:system:generated:index/applib/annotation/Redirect.adoc.adoc[Redirect]`
+<.> `[teal]#*_redirectPolicy_*#` : `xref:system:generated:index/applib/annotation/Redirect.adoc[Redirect]`
 +
 --
 If the action returns its target, then determines whether to update the page or instead to redirect (forcing a re-rendering of a new page).
diff --git a/antora/components/system/modules/generated/pages/index/applib/annotation/Collection.adoc b/antora/components/system/modules/generated/pages/index/applib/annotation/Collection.adoc
index 8126e2fc..3fa05c7 100644
--- a/antora/components/system/modules/generated/pages/index/applib/annotation/Collection.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/annotation/Collection.adoc
@@ -39,7 +39,7 @@ public class Order {
 
 This subclass must provide a no-arg constructor; the fields are set reflectively.
 --
-<.> `[teal]#*_editing_*#` : `xref:system:generated:index/applib/annotation/Editing.adoc.adoc[Editing]`
+<.> `[teal]#*_editing_*#` : `xref:system:generated:index/applib/annotation/Editing.adoc[Editing]`
 +
 --
 Whether the properties of this domain object can be edited, or collections of this object be added to/removed from.
@@ -51,7 +51,7 @@ Note that non-editable objects can nevertheless have actions invoked upon them.
 --
 If _#editing()_ is set to _Editing#DISABLED_ , then the reason to provide to the user as to why this property cannot be edited.
 --
-<.> `[teal]#*_hidden_*#` : `xref:system:generated:index/applib/annotation/Where.adoc.adoc[Where]`
+<.> `[teal]#*_hidden_*#` : `xref:system:generated:index/applib/annotation/Where.adoc[Where]`
 +
 --
 Indicates when the collection is not visible to the user.
diff --git a/antora/components/system/modules/generated/pages/index/applib/annotation/CollectionLayout.adoc b/antora/components/system/modules/generated/pages/index/applib/annotation/CollectionLayout.adoc
index 02e5e01..1d4f098 100644
--- a/antora/components/system/modules/generated/pages/index/applib/annotation/CollectionLayout.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/annotation/CollectionLayout.adoc
@@ -44,7 +44,7 @@ The only view available within the core framework is "table". However, other vie
 --
 Description of this collection, eg to be rendered in a tooltip.
 --
-<.> `[teal]#*_hidden_*#` : `xref:system:generated:index/applib/annotation/Where.adoc.adoc[Where]`
+<.> `[teal]#*_hidden_*#` : `xref:system:generated:index/applib/annotation/Where.adoc[Where]`
 +
 --
 Indicates where in the UI the collection should _not_ not be visible.
diff --git a/antora/components/system/modules/generated/pages/index/applib/annotation/Defaulted.adoc b/antora/components/system/modules/generated/pages/index/applib/annotation/Defaulted.adoc
index 51571da..0905995 100644
--- a/antora/components/system/modules/generated/pages/index/applib/annotation/Defaulted.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/annotation/Defaulted.adoc
@@ -1,9 +1,9 @@
 = Defaulted : _annotation_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-Indicates that the class should have a default, by providing a link to a xref:system:generated:index/applib/adapters/DefaultsProvider.adoc.adoc[DefaultsProvider] , or some externally-configured mechanism.
+Indicates that the class should have a default, by providing a link to a xref:system:generated:index/applib/adapters/DefaultsProvider.adoc[DefaultsProvider] , or some externally-configured mechanism.
 
-This possibly seems a little tortuous. The more obvious means to provide a default would seem to be a simple `@DefaultsTo(new SomeObject())` . However, Java only allows primitives, strings and class literals to be used in annotations. We therefore need delegate to an external implementation. (This more complex design is also more flexible of course; the implementation of xref:system:generated:index/applib/adapters/DefaultsProvider.adoc.adoc[DefaultsProvider] could adjust the default it p [...]
+This possibly seems a little tortuous. The more obvious means to provide a default would seem to be a simple `@DefaultsTo(new SomeObject())` . However, Java only allows primitives, strings and class literals to be used in annotations. We therefore need delegate to an external implementation. (This more complex design is also more flexible of course; the implementation of xref:system:generated:index/applib/adapters/DefaultsProvider.adoc[DefaultsProvider] could adjust the default it provid [...]
 
 .Java Sources
 [source,java]
@@ -19,7 +19,7 @@ This possibly seems a little tortuous. The more obvious means to provide a defau
 <.> `[teal]#*_defaultsProviderName_*#` : `String`
 +
 --
-The fully qualified name of a class that implements the xref:system:generated:index/applib/adapters/DefaultsProvider.adoc.adoc[DefaultsProvider] interface.
+The fully qualified name of a class that implements the xref:system:generated:index/applib/adapters/DefaultsProvider.adoc[DefaultsProvider] interface.
 
 This is optional because some implementations may pick up the defaults provider via a configuration file, or via the equivalent _#defaultsProviderClass()_ .
 
@@ -30,6 +30,6 @@ Implementation note: the default value provided here is simply an empty string b
 --
 As per _#defaultsProviderName()_ , but specifying a class literal rather than a fully qualified class name.
 
-Implementation note: the default value provided here is simply the xref:system:generated:index/applib/annotation/Defaulted.adoc.adoc[Defaulted] 's own class, because `null` is not a valid default.
+Implementation note: the default value provided here is simply the xref:system:generated:index/applib/annotation/Defaulted.adoc[Defaulted] 's own class, because `null` is not a valid default.
 --
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/annotation/DomainObject.adoc b/antora/components/system/modules/generated/pages/index/applib/annotation/DomainObject.adoc
index c178654..30d4d8f 100644
--- a/antora/components/system/modules/generated/pages/index/applib/annotation/DomainObject.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/annotation/DomainObject.adoc
@@ -62,7 +62,7 @@ The method (despite its name, not necessarily an action) to use in order to perf
 
 The method is required to accept a single string parameter, and must return a list of the domain type.
 --
-<.> `[teal]#*_bounding_*#` : `xref:system:generated:index/applib/annotation/Bounding.adoc.adoc[Bounding]`
+<.> `[teal]#*_bounding_*#` : `xref:system:generated:index/applib/annotation/Bounding.adoc[Bounding]`
 +
 --
 Indicates that the class has a bounded, or finite, set of instances.
@@ -71,7 +71,7 @@ Takes precedence over auto-complete.
 
 Note: this replaces bounded=true|false prior to v2.x
 --
-<.> `[teal]#*_editing_*#` : `xref:system:generated:index/applib/annotation/Editing.adoc.adoc[Editing]`
+<.> `[teal]#*_editing_*#` : `xref:system:generated:index/applib/annotation/Editing.adoc[Editing]`
 +
 --
 Whether the properties of this domain object can be edited, or collections of this object be added to/removed from.
@@ -83,7 +83,7 @@ Note that non-editable objects can nevertheless have actions invoked upon them.
 --
 If _#editing()_ is set to _Editing#DISABLED_ , then the reason to provide to the user as to why the object's properties cannot be edited/collections modified.
 --
-<.> `[teal]#*_entityChangePublishing_*#` : `xref:system:generated:index/applib/annotation/Publishing.adoc.adoc[Publishing]`
+<.> `[teal]#*_entityChangePublishing_*#` : `xref:system:generated:index/applib/annotation/Publishing.adoc[Publishing]`
 +
 --
 Whether entity changes should be published to _org.apache.isis.applib.services.publishing.spi.EntityPropertyChangeSubscriber_ s and whether entity changes, captured as _org.apache.isis.applib.services.publishing.spi.EntityChanges_ , should be dispatched to _org.apache.isis.applib.services.publishing.spi.EntityChangesSubscriber_ s.
@@ -95,7 +95,7 @@ Equivalent to _Mixin#method()_ .
 
 Applicable only if _#nature()_ is _Nature#MIXIN_ .
 --
-<.> `[teal]#*_nature_*#` : `xref:system:generated:index/applib/annotation/Nature.adoc.adoc[Nature]`
+<.> `[teal]#*_nature_*#` : `xref:system:generated:index/applib/annotation/Nature.adoc[Nature]`
 +
 --
 The nature of this domain object.
@@ -159,7 +159,7 @@ This subclass must provide a no-arg constructor; the fields are set reflectively
 <.> `[teal]#*_actionDomainEvent_*#` : `Class<? extends ActionDomainEvent<?>>`
 +
 --
-Indicates that an invocation of _any_ action of the domain object (that do not themselves specify their own `@Action(domainEvent=...)` should be posted to the _org.apache.isis.applib.services.eventbus.EventBusService event bus_ using the specified custom (subclass of) xref:system:generated:index/applib/events/domain/ActionDomainEvent.adoc.adoc[ActionDomainEvent] .
+Indicates that an invocation of _any_ action of the domain object (that do not themselves specify their own `@Action(domainEvent=...)` should be posted to the _org.apache.isis.applib.services.eventbus.EventBusService event bus_ using the specified custom (subclass of) xref:system:generated:index/applib/events/domain/ActionDomainEvent.adoc[ActionDomainEvent] .
 
 For example:
 
@@ -181,7 +181,7 @@ This subclass must provide a no-arg constructor; the fields are set reflectively
 <.> `[teal]#*_propertyDomainEvent_*#` : `Class<? extends PropertyDomainEvent<?,?>>`
 +
 --
-Indicates that changes to _any_ property of the domain object (that do not themselves specify their own `@Property(domainEvent=...)` should be posted to the _org.apache.isis.applib.services.eventbus.EventBusService event bus_ using the specified custom (subclass of) xref:system:generated:index/applib/events/domain/PropertyDomainEvent.adoc.adoc[PropertyDomainEvent] .
+Indicates that changes to _any_ property of the domain object (that do not themselves specify their own `@Property(domainEvent=...)` should be posted to the _org.apache.isis.applib.services.eventbus.EventBusService event bus_ using the specified custom (subclass of) xref:system:generated:index/applib/events/domain/PropertyDomainEvent.adoc[PropertyDomainEvent] .
 
 For example:
 
@@ -199,7 +199,7 @@ This subclass must provide a no-arg constructor; the fields are set reflectively
 <.> `[teal]#*_collectionDomainEvent_*#` : `Class<? extends CollectionDomainEvent<?,?>>`
 +
 --
-Indicates that changes to _any_ collection of the domain object (that do not themselves specify their own `@Collection(domainEvent=...)` should be posted to the _org.apache.isis.applib.services.eventbus.EventBusService event bus_ using a custom (subclass of) xref:system:generated:index/applib/events/domain/CollectionDomainEvent.adoc.adoc[CollectionDomainEvent] .
+Indicates that changes to _any_ collection of the domain object (that do not themselves specify their own `@Collection(domainEvent=...)` should be posted to the _org.apache.isis.applib.services.eventbus.EventBusService event bus_ using a custom (subclass of) xref:system:generated:index/applib/events/domain/CollectionDomainEvent.adoc[CollectionDomainEvent] .
 
 For example:
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/annotation/DomainObjectLayout.adoc b/antora/components/system/modules/generated/pages/index/applib/annotation/DomainObjectLayout.adoc
index 28c18e2..9f306e8 100644
--- a/antora/components/system/modules/generated/pages/index/applib/annotation/DomainObjectLayout.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/annotation/DomainObjectLayout.adoc
@@ -34,7 +34,7 @@ Layout hints for domain objects.
 }
 ----
 
-<.> `[teal]#*_bookmarking_*#` : `xref:system:generated:index/applib/annotation/BookmarkPolicy.adoc.adoc[BookmarkPolicy]`
+<.> `[teal]#*_bookmarking_*#` : `xref:system:generated:index/applib/annotation/BookmarkPolicy.adoc[BookmarkPolicy]`
 +
 --
 Whether (and how) this domain object can be bookmarked in the UI.
@@ -83,7 +83,7 @@ The plural name of the class.
 <.> `[teal]#*_cssClassUiEvent_*#` : `Class<? extends CssClassUiEvent<?>>`
 +
 --
-Which subclass of xref:system:generated:index/applib/events/ui/CssClassUiEvent.adoc.adoc[CssClassUiEvent] should be used to obtain a CSS class.
+Which subclass of xref:system:generated:index/applib/events/ui/CssClassUiEvent.adoc[CssClassUiEvent] should be used to obtain a CSS class.
 
 This subclass must provide a no-arg constructor; the fields are set reflectively.
 --
@@ -97,14 +97,14 @@ This subclass must provide a no-arg constructor; the fields are set reflectively
 <.> `[teal]#*_layoutUiEvent_*#` : `Class<? extends LayoutUiEvent<?>>`
 +
 --
-Which subclass of xref:system:generated:index/applib/events/ui/LayoutUiEvent.adoc.adoc[LayoutUiEvent] should be used to obtain a layout.
+Which subclass of xref:system:generated:index/applib/events/ui/LayoutUiEvent.adoc[LayoutUiEvent] should be used to obtain a layout.
 
 This subclass must provide a no-arg constructor; the fields are set reflectively.
 --
 <.> `[teal]#*_titleUiEvent_*#` : `Class<? extends TitleUiEvent<?>>`
 +
 --
-Which subclass of xref:system:generated:index/applib/events/ui/TitleUiEvent.adoc.adoc[TitleUiEvent] should be used to obtain a title.
+Which subclass of xref:system:generated:index/applib/events/ui/TitleUiEvent.adoc[TitleUiEvent] should be used to obtain a title.
 
 This subclass must provide a no-arg constructor; the fields are set reflectively.
 --
diff --git a/antora/components/system/modules/generated/pages/index/applib/annotation/DomainService.adoc b/antora/components/system/modules/generated/pages/index/applib/annotation/DomainService.adoc
index 1fd805c..2c37316 100644
--- a/antora/components/system/modules/generated/pages/index/applib/annotation/DomainService.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/annotation/DomainService.adoc
@@ -16,7 +16,7 @@ Also indicates whether the domain service acts as a repository for an entity, an
 }
 ----
 
-<.> `[teal]#*_nature_*#` : `xref:system:generated:index/applib/annotation/NatureOfService.adoc.adoc[NatureOfService]`
+<.> `[teal]#*_nature_*#` : `xref:system:generated:index/applib/annotation/NatureOfService.adoc[NatureOfService]`
 +
 --
 The nature of this service, eg for menus, contributed actions, repository.
diff --git a/antora/components/system/modules/generated/pages/index/applib/annotation/Nature.adoc b/antora/components/system/modules/generated/pages/index/applib/annotation/Nature.adoc
index bc8f886..d275e92 100644
--- a/antora/components/system/modules/generated/pages/index/applib/annotation/Nature.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/annotation/Nature.adoc
@@ -29,7 +29,7 @@ enum Nature {
 <.> `[teal]#*_NOT_SPECIFIED_*#`
 +
 --
-The default; allows the programmer to combine `@DomainObject` annotation with the xref:system:generated:index/applib/ViewModel.adoc.adoc[ViewModel] annotation, or the _XmlRootElement_ annotation, or by implementing the _org.apache.isis.applib.ViewModel_ interface.
+The default; allows the programmer to combine `@DomainObject` annotation with the xref:system:generated:index/applib/ViewModel.adoc[ViewModel] annotation, or the _XmlRootElement_ annotation, or by implementing the _org.apache.isis.applib.ViewModel_ interface.
 --
 <.> `[teal]#*_JDO_ENTITY_*#`
 +
@@ -54,7 +54,7 @@ Currently implies no additional semantics other than documentation.
 --
 An object that is conceptually part of the application layer, and which surfaces behavior and/or state that is aggregate of one or more domain entity.
 
-The identity of a view model is determined solely by the state of object's properties (that have not been set to be ignored using _org.apache.isis.applib.annotation.Property#notPersisted()_ ). Using this nature should be considered exactly equivalent to annotating with xref:system:generated:index/applib/ViewModel.adoc.adoc[ViewModel] .
+The identity of a view model is determined solely by the state of object's properties (that have not been set to be ignored using _org.apache.isis.applib.annotation.Property#notPersisted()_ ). Using this nature should be considered exactly equivalent to annotating with xref:system:generated:index/applib/ViewModel.adoc[ViewModel] .
 
 Note that collections are ignored; if their state is required to fully identify the view model, define the view model using the JAXB _XmlRootElement_ annotation instead (where the object's state is serialized to an arbitrarily deep graph of data, with references to persistent entities transparently resolved to<oid-dto>elements).
 --
diff --git a/antora/components/system/modules/generated/pages/index/applib/annotation/Parameter.adoc b/antora/components/system/modules/generated/pages/index/applib/annotation/Parameter.adoc
index 805c7aa..fe98ee4 100644
--- a/antora/components/system/modules/generated/pages/index/applib/annotation/Parameter.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/annotation/Parameter.adoc
@@ -27,7 +27,7 @@ Domain semantics for domain object collection.
 <.> `[teal]#*_fileAccept_*#` : `String`
 +
 --
-For uploading xref:system:generated:index/applib/value/Blob.adoc.adoc[Blob] or xref:system:generated:index/applib/value/Clob.adoc.adoc[Clob] , optionally restrict the files accepted (eg `.xslx` ).
+For uploading xref:system:generated:index/applib/value/Blob.adoc[Blob] or xref:system:generated:index/applib/value/Clob.adoc[Clob] , optionally restrict the files accepted (eg `.xslx` ).
 
 The value should be of the form "file_extension|audio/*|video/*|image/*|media_type".
 --
@@ -45,7 +45,7 @@ The _org.apache.isis.applib.spec.Specification_ (s) to be satisfied by this para
 
 If more than one is provided, then all must be satisfied (in effect "AND"ed together).
 --
-<.> `[teal]#*_optionality_*#` : `xref:system:generated:index/applib/annotation/Optionality.adoc.adoc[Optionality]`
+<.> `[teal]#*_optionality_*#` : `xref:system:generated:index/applib/annotation/Optionality.adoc[Optionality]`
 +
 --
 Whether this parameter is optional or is mandatory (ie required).
diff --git a/antora/components/system/modules/generated/pages/index/applib/annotation/ParameterLayout.adoc b/antora/components/system/modules/generated/pages/index/applib/annotation/ParameterLayout.adoc
index c3ed5e9..00c62b6 100644
--- a/antora/components/system/modules/generated/pages/index/applib/annotation/ParameterLayout.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/annotation/ParameterLayout.adoc
@@ -36,7 +36,7 @@ Indicates the css class that a parameter should have.
 --
 Description of this property, eg to be rendered in a tooltip.
 --
-<.> `[teal]#*_labelPosition_*#` : `xref:system:generated:index/applib/annotation/LabelPosition.adoc.adoc[LabelPosition]`
+<.> `[teal]#*_labelPosition_*#` : `xref:system:generated:index/applib/annotation/LabelPosition.adoc[LabelPosition]`
 +
 --
 In forms, positioning of the label (left, top or none) relative to the parameter value.
@@ -58,7 +58,7 @@ A flag indicating whether the value of _#named()_ should be HTML escaped or not.
 --
 For string parameters (and properties), whether to render as a text area over multiple lines.
 --
-<.> `[teal]#*_renderDay_*#` : `xref:system:generated:index/applib/annotation/RenderDay.adoc.adoc[RenderDay]`
+<.> `[teal]#*_renderDay_*#` : `xref:system:generated:index/applib/annotation/RenderDay.adoc[RenderDay]`
 +
 --
 For date parameters (and properties) only, instructs the viewer that the date should be rendered as one day prior to the actually stored date.
diff --git a/antora/components/system/modules/generated/pages/index/applib/annotation/Property.adoc b/antora/components/system/modules/generated/pages/index/applib/annotation/Property.adoc
index 9b6506b..ba77536 100644
--- a/antora/components/system/modules/generated/pages/index/applib/annotation/Property.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/annotation/Property.adoc
@@ -45,14 +45,14 @@ Domain semantics for domain object property.
 <.> `[teal]#*_commandDtoProcessor_*#` : `Class<? extends CommandDtoProcessor>`
 +
 --
-The xref:system:generated:index/applib/services/commanddto/processor/CommandDtoProcessor.adoc.adoc[CommandDtoProcessor] to process this command's DTO.
+The xref:system:generated:index/applib/services/commanddto/processor/CommandDtoProcessor.adoc[CommandDtoProcessor] to process this command's DTO.
 
-The processor itself is used by xref:system:generated:index/applib/services/commanddto/conmap/ContentMappingServiceForCommandDto.adoc.adoc[ContentMappingServiceForCommandDto] and xref:system:generated:index/applib/services/commanddto/conmap/ContentMappingServiceForCommandsDto.adoc.adoc[ContentMappingServiceForCommandsDto] to dynamically transform the DTOs.
+The processor itself is used by xref:system:generated:index/applib/services/commanddto/conmap/ContentMappingServiceForCommandDto.adoc[ContentMappingServiceForCommandDto] and xref:system:generated:index/applib/services/commanddto/conmap/ContentMappingServiceForCommandsDto.adoc[ContentMappingServiceForCommandsDto] to dynamically transform the DTOs.
 --
-<.> `[teal]#*_commandPublishing_*#` : `xref:system:generated:index/applib/annotation/Publishing.adoc.adoc[Publishing]`
+<.> `[teal]#*_commandPublishing_*#` : `xref:system:generated:index/applib/annotation/Publishing.adoc[Publishing]`
 +
 --
-Whether property edits, captured as xref:system:generated:index/applib/services/command/Command.adoc.adoc[Command] s, should be published to xref:system:generated:index/applib/services/publishing/spi/CommandSubscriber.adoc.adoc[CommandSubscriber] s.
+Whether property edits, captured as xref:system:generated:index/applib/services/command/Command.adoc[Command] s, should be published to xref:system:generated:index/applib/services/publishing/spi/CommandSubscriber.adoc[CommandSubscriber] s.
 --
 <.> `[teal]#*_domainEvent_*#` : `Class<? extends PropertyDomainEvent<?,?>>`
 +
@@ -71,7 +71,7 @@ public LocalDate getStartDate() { ...}
 
 This subclass must provide a no-arg constructor; the fields are set reflectively.
 --
-<.> `[teal]#*_editing_*#` : `xref:system:generated:index/applib/annotation/Editing.adoc.adoc[Editing]`
+<.> `[teal]#*_editing_*#` : `xref:system:generated:index/applib/annotation/Editing.adoc[Editing]`
 +
 --
 Whether the properties of this domain object can be edited, or collections of this object be added to/removed from.
@@ -83,19 +83,19 @@ Note that non-editable objects can nevertheless have actions invoked upon them.
 --
 If _#editing()_ is set to _Editing#DISABLED_ , then the reason to provide to the user as to why this property cannot be edited.
 --
-<.> `[teal]#*_executionPublishing_*#` : `xref:system:generated:index/applib/annotation/Publishing.adoc.adoc[Publishing]`
+<.> `[teal]#*_executionPublishing_*#` : `xref:system:generated:index/applib/annotation/Publishing.adoc[Publishing]`
 +
 --
-Whether _Interaction.Execution_ s (triggered property edits), should be dispatched to xref:system:generated:index/applib/services/publishing/spi/ExecutionSubscriber.adoc.adoc[ExecutionSubscriber] s.
+Whether _Interaction.Execution_ s (triggered property edits), should be dispatched to xref:system:generated:index/applib/services/publishing/spi/ExecutionSubscriber.adoc[ExecutionSubscriber] s.
 --
 <.> `[teal]#*_fileAccept_*#` : `String`
 +
 --
-For uploading xref:system:generated:index/applib/value/Blob.adoc.adoc[Blob] or xref:system:generated:index/applib/value/Clob.adoc.adoc[Clob] , optionally restrict the files accepted (eg `.xslx` ).
+For uploading xref:system:generated:index/applib/value/Blob.adoc[Blob] or xref:system:generated:index/applib/value/Clob.adoc[Clob] , optionally restrict the files accepted (eg `.xslx` ).
 
 The value should be of the form "file_extension|audio/*|video/*|image/*|media_type".
 --
-<.> `[teal]#*_hidden_*#` : `xref:system:generated:index/applib/annotation/Where.adoc.adoc[Where]`
+<.> `[teal]#*_hidden_*#` : `xref:system:generated:index/applib/annotation/Where.adoc[Where]`
 +
 --
 Indicates where the property is not visible to the user.
@@ -107,7 +107,7 @@ The maximum entry length of a field.
 
 The default value (-1) indicates that no maxLength has been specified.
 --
-<.> `[teal]#*_mementoSerialization_*#` : `xref:system:generated:index/applib/annotation/MementoSerialization.adoc.adoc[MementoSerialization]`
+<.> `[teal]#*_mementoSerialization_*#` : `xref:system:generated:index/applib/annotation/MementoSerialization.adoc[MementoSerialization]`
 +
 --
 Indicates whether the property should be included or excluded from mementos.
@@ -121,14 +121,14 @@ The _org.apache.isis.applib.spec.Specification_ (s) to be satisfied by this prop
 
 If more than one is provided, then all must be satisfied (in effect "AND"ed together).
 --
-<.> `[teal]#*_optionality_*#` : `xref:system:generated:index/applib/annotation/Optionality.adoc.adoc[Optionality]`
+<.> `[teal]#*_optionality_*#` : `xref:system:generated:index/applib/annotation/Optionality.adoc[Optionality]`
 +
 --
 Whether this property is optional or is mandatory (ie required).
 
 For properties the default value, _org.apache.isis.applib.annotation.Optionality#DEFAULT_ , usually means that the property is required unless it has been overridden byjavax.jdo.annotations.Columnwith itsjavax.jdo.annotations.Column#allowsNull()attribute set to true.
 --
-<.> `[teal]#*_projecting_*#` : `xref:system:generated:index/applib/annotation/Projecting.adoc.adoc[Projecting]`
+<.> `[teal]#*_projecting_*#` : `xref:system:generated:index/applib/annotation/Projecting.adoc[Projecting]`
 +
 --
 If set to _Projecting#PROJECTED projected_ , then indicates that the owner of this property is a view model which is a projection of some other entity, and that the property holds a reference to that "underlying".
diff --git a/antora/components/system/modules/generated/pages/index/applib/annotation/PropertyLayout.adoc b/antora/components/system/modules/generated/pages/index/applib/annotation/PropertyLayout.adoc
index 944a81b..efca208 100644
--- a/antora/components/system/modules/generated/pages/index/applib/annotation/PropertyLayout.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/annotation/PropertyLayout.adoc
@@ -44,12 +44,12 @@ Indicates the css class that a property should have.
 --
 Description of this property, eg to be rendered in a tooltip.
 --
-<.> `[teal]#*_hidden_*#` : `xref:system:generated:index/applib/annotation/Where.adoc.adoc[Where]`
+<.> `[teal]#*_hidden_*#` : `xref:system:generated:index/applib/annotation/Where.adoc[Where]`
 +
 --
 Indicates where in the UI the property should _not_ not be visible.
 --
-<.> `[teal]#*_labelPosition_*#` : `xref:system:generated:index/applib/annotation/LabelPosition.adoc.adoc[LabelPosition]`
+<.> `[teal]#*_labelPosition_*#` : `xref:system:generated:index/applib/annotation/LabelPosition.adoc[LabelPosition]`
 +
 --
 In forms, positioning of the label (left, top or none) relative to the property value.
@@ -71,19 +71,19 @@ Name of this property (overriding the name derived from its name in code).
 --
 A flag indicating whether the value of _#named()_ should be HTML escaped or not.
 --
-<.> `[teal]#*_navigable_*#` : `xref:system:generated:index/applib/annotation/Navigable.adoc.adoc[Navigable]`
+<.> `[teal]#*_navigable_*#` : `xref:system:generated:index/applib/annotation/Navigable.adoc[Navigable]`
 +
 --
 Whether this property should be used to construct the navigable chain of breadcrumbs in the UI.
 
 Only one property can be annotated as such per domain class.
 --
-<.> `[teal]#*_promptStyle_*#` : `xref:system:generated:index/applib/annotation/PromptStyle.adoc.adoc[PromptStyle]`
+<.> `[teal]#*_promptStyle_*#` : `xref:system:generated:index/applib/annotation/PromptStyle.adoc[PromptStyle]`
 +
 --
 How the properties of this domain object are be edited, either _PromptStyle#DIALOG dialog_ or _PromptStyle#INLINE inline_ .
 --
-<.> `[teal]#*_renderDay_*#` : `xref:system:generated:index/applib/annotation/RenderDay.adoc.adoc[RenderDay]`
+<.> `[teal]#*_renderDay_*#` : `xref:system:generated:index/applib/annotation/RenderDay.adoc[RenderDay]`
 +
 --
 For date properties (and parameters) only, instructs the viewer that the date should be rendered as one day prior to the actually stored date.
@@ -102,7 +102,7 @@ public LocalDate getEndDate() { ... }
 
 Here, the interval of the [1-may-2013,1-jun-2013) would be rendered as the dates 1-may-2013 for the start date but using 31-may-2013 (the day before) for the end date. What is stored In the domain object, itself, however, the value stored is 1-jun-2013.
 --
-<.> `[teal]#*_repainting_*#` : `xref:system:generated:index/applib/annotation/Repainting.adoc.adoc[Repainting]`
+<.> `[teal]#*_repainting_*#` : `xref:system:generated:index/applib/annotation/Repainting.adoc[Repainting]`
 +
 --
 Indicates that the value held by the property never changes over time, even when other properties of the object do change.
@@ -111,7 +111,7 @@ Setting this attribute to `RepaintPolicy.NO_REPAINT` is used as a hint to the vi
 
 Note that for this to work, the viewer will also ensure that none of the property's parent component (such as a tab group panel) are re-rendered.
 
-Design note: we considered implementing this an "immutable" flag on the xref:system:generated:index/applib/annotation/Property.adoc.adoc[Property] annotation (because this flag is typically appropriate for immutable/unchanging properties of a domain object). However, we decided not to do that, on the basis that it might be interpreted as having a deeper impact within the framework than simply a hint for rendering.
+Design note: we considered implementing this an "immutable" flag on the xref:system:generated:index/applib/annotation/Property.adoc[Property] annotation (because this flag is typically appropriate for immutable/unchanging properties of a domain object). However, we decided not to do that, on the basis that it might be interpreted as having a deeper impact within the framework than simply a hint for rendering.
 --
 <.> `[teal]#*_typicalLength_*#` : `int`
 +
diff --git a/antora/components/system/modules/generated/pages/index/applib/annotation/Publishing.adoc b/antora/components/system/modules/generated/pages/index/applib/annotation/Publishing.adoc
index 3a0185a..4c1a189 100644
--- a/antora/components/system/modules/generated/pages/index/applib/annotation/Publishing.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/annotation/Publishing.adoc
@@ -3,16 +3,16 @@
 
 The available policies as to whether data should be published to corresponding subscribers. The framework supports several kinds of data that are available for publishing:
 
-* *xref:system:generated:index/applib/services/publishing/spi/EntityChanges.adoc.adoc[EntityChanges] ... subscribed to via xref:system:generated:index/applib/services/publishing/spi/EntityChangesSubscriber.adoc.adoc[EntityChangesSubscriber]*
+* *xref:system:generated:index/applib/services/publishing/spi/EntityChanges.adoc[EntityChanges] ... subscribed to via xref:system:generated:index/applib/services/publishing/spi/EntityChangesSubscriber.adoc[EntityChangesSubscriber]*
 
  *
-* *xref:system:generated:index/applib/services/publishing/spi/EntityPropertyChange.adoc.adoc[EntityPropertyChange] ... subscribed to via xref:system:generated:index/applib/services/publishing/spi/EntityPropertyChangeSubscriber.adoc.adoc[EntityPropertyChangeSubscriber]*
+* *xref:system:generated:index/applib/services/publishing/spi/EntityPropertyChange.adoc[EntityPropertyChange] ... subscribed to via xref:system:generated:index/applib/services/publishing/spi/EntityPropertyChangeSubscriber.adoc[EntityPropertyChangeSubscriber]*
 
  *
-* *xref:system:generated:index/applib/services/command/Command.adoc.adoc[Command] ... subscribed to via xref:system:generated:index/applib/services/publishing/spi/CommandSubscriber.adoc.adoc[CommandSubscriber]*
+* *xref:system:generated:index/applib/services/command/Command.adoc[Command] ... subscribed to via xref:system:generated:index/applib/services/publishing/spi/CommandSubscriber.adoc[CommandSubscriber]*
 
  *
-* *_Interaction.Execution_ ... subscribed to via xref:system:generated:index/applib/services/publishing/spi/ExecutionSubscriber.adoc.adoc[ExecutionSubscriber]*
+* *_Interaction.Execution_ ... subscribed to via xref:system:generated:index/applib/services/publishing/spi/ExecutionSubscriber.adoc[ExecutionSubscriber]*
 
  ** * * * 
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/annotation/Title.adoc b/antora/components/system/modules/generated/pages/index/applib/annotation/Title.adoc
index 13201a3..64b286a 100644
--- a/antora/components/system/modules/generated/pages/index/applib/annotation/Title.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/annotation/Title.adoc
@@ -21,7 +21,7 @@ A title annotation used to annotate methods used to construct the title of a dom
 <.> `[teal]#*_sequence_*#` : `String`
 +
 --
-The order (in Dewey decimal notation) that the property annotated with xref:system:generated:index/applib/annotation/Title.adoc.adoc[Title] appears with respect to other properties also annotated with xref:system:generated:index/applib/annotation/Title.adoc.adoc[Title] .
+The order (in Dewey decimal notation) that the property annotated with xref:system:generated:index/applib/annotation/Title.adoc[Title] appears with respect to other properties also annotated with xref:system:generated:index/applib/annotation/Title.adoc[Title] .
 --
 <.> `[teal]#*_prepend_*#` : `String`
 +
diff --git a/antora/components/system/modules/generated/pages/index/applib/annotation/Value.adoc b/antora/components/system/modules/generated/pages/index/applib/annotation/Value.adoc
index 0fb6e5c..dd4f605 100644
--- a/antora/components/system/modules/generated/pages/index/applib/annotation/Value.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/annotation/Value.adoc
@@ -8,10 +8,10 @@ By "value semantics" all we actually mean that the class is aggregated (or embed
 * it may be parseable
 * it may be encodeable
 * it may be immutable, and by default is presumed that it is
-* it may follow the equal-by-content contract (as per xref:system:generated:index/applib/annotation/EqualByContent.adoc.adoc[EqualByContent] ), and by default is presumed that it does.
+* it may follow the equal-by-content contract (as per xref:system:generated:index/applib/annotation/EqualByContent.adoc[EqualByContent] ), and by default is presumed that it does.
 +
 --
-Note also that though a value is conceptually not shared, if it is also immutable then it is in fact safe to share objects (as in the flyweight pattern). In addition, the xref:system:generated:index/applib/annotation/EqualByContent.adoc.adoc[EqualByContent] semantic means that we needn't care whether value types are being shared or not.
+Note also that though a value is conceptually not shared, if it is also immutable then it is in fact safe to share objects (as in the flyweight pattern). In addition, the xref:system:generated:index/applib/annotation/EqualByContent.adoc[EqualByContent] semantic means that we needn't care whether value types are being shared or not.
 --
 
 .Java Sources
@@ -28,11 +28,11 @@ Note also that though a value is conceptually not shared, if it is also immutabl
 <.> `[teal]#*_semanticsProviderName_*#` : `String`
 +
 --
-The fully qualified name of a class that implements the xref:system:generated:index/applib/adapters/ValueSemanticsProvider.adoc.adoc[ValueSemanticsProvider] interface.
+The fully qualified name of a class that implements the xref:system:generated:index/applib/adapters/ValueSemanticsProvider.adoc[ValueSemanticsProvider] interface.
 
 This is optional because some implementations may pick up encodeability via a configuration file, or via the equivalent _#semanticsProviderClass()_ .
 
-It is possible for value classes to act as their own semantics providers, and may in particular implement the xref:system:generated:index/applib/adapters/EncoderDecoder.adoc.adoc[EncoderDecoder] interface. The framework requires that the nominated class provides a `public` no-arg constructor on the class, and will instantiates an instance of the class to interact with it. In the case of encoding, the framework uses the result of discards the instantiated object. What that means in partic [...]
+It is possible for value classes to act as their own semantics providers, and may in particular implement the xref:system:generated:index/applib/adapters/EncoderDecoder.adoc[EncoderDecoder] interface. The framework requires that the nominated class provides a `public` no-arg constructor on the class, and will instantiates an instance of the class to interact with it. In the case of encoding, the framework uses the result of discards the instantiated object. What that means in particular  [...]
 
 Implementation note: the default value provided here is simply an empty string because `null` is not a valid default.
 --
@@ -41,6 +41,6 @@ Implementation note: the default value provided here is simply an empty string b
 --
 As per _#semanticsProviderName()_ , but specifying a class literal rather than a fully qualified class name.
 
-Implementation note: the default value provided here is simply the xref:system:generated:index/applib/annotation/Value.adoc.adoc[Value] 's own class, because `null` is not a valid default.
+Implementation note: the default value provided here is simply the xref:system:generated:index/applib/annotation/Value.adoc[Value] 's own class, because `null` is not a valid default.
 --
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/annotation/Where.adoc b/antora/components/system/modules/generated/pages/index/applib/annotation/Where.adoc
index 59208b1..56240cf 100644
--- a/antora/components/system/modules/generated/pages/index/applib/annotation/Where.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/annotation/Where.adoc
@@ -112,7 +112,7 @@ For example, if a property is annotated with `@Title` , then normally this shoul
 --
 Acts as the default no-op value for _PropertyLayout#hidden()_ , _CollectionLayout#hidden()_ and _ActionLayout#hidden()_ .
 --
-<.> `[teal]#*includes*#(xref:system:generated:index/applib/annotation/Where.adoc.adoc[Where] context)` : `boolean`
+<.> `[teal]#*includes*#(xref:system:generated:index/applib/annotation/Where.adoc[Where] context)` : `boolean`
 +
 --
 Whether this `Where` is a superset of the context `Where` provided.
diff --git a/antora/components/system/modules/generated/pages/index/applib/clock/VirtualClock.adoc b/antora/components/system/modules/generated/pages/index/applib/clock/VirtualClock.adoc
index da7bdaf..1bc57a2 100644
--- a/antora/components/system/modules/generated/pages/index/applib/clock/VirtualClock.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/clock/VirtualClock.adoc
@@ -1,7 +1,7 @@
 = VirtualClock : _interface_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-Works in connection with _InteractionFactory_ , such that it allows an xref:system:generated:index/applib/services/iactn/Interaction.adoc.adoc[Interaction] to run with its own simulated (or actual) time.
+Works in connection with _InteractionFactory_ , such that it allows an xref:system:generated:index/applib/services/iactn/Interaction.adoc[Interaction] to run with its own simulated (or actual) time.
 
 Relates to _VirtualContext_
 
@@ -45,22 +45,22 @@ interface VirtualClock {
 --
 Returns the (virtual) time as an _Instant_ .
 --
-<.> `[teal]#*_system_*#()` : `xref:system:generated:index/applib/clock/VirtualClock.adoc.adoc[VirtualClock]`
+<.> `[teal]#*_system_*#()` : `xref:system:generated:index/applib/clock/VirtualClock.adoc[VirtualClock]`
 +
 --
 Returns a the system's default ticking clock.
 --
-<.> `[teal]#*_nowAt_*#(Instant virtualNow)` : `xref:system:generated:index/applib/clock/VirtualClock.adoc.adoc[VirtualClock]`
+<.> `[teal]#*_nowAt_*#(Instant virtualNow)` : `xref:system:generated:index/applib/clock/VirtualClock.adoc[VirtualClock]`
 +
 --
 Returns a ticking clock set to virtual time _Instant_ _virtualNow_
 --
-<.> `[teal]#*_frozenAt_*#(Instant frozenAt)` : `xref:system:generated:index/applib/clock/VirtualClock.adoc.adoc[VirtualClock]`
+<.> `[teal]#*_frozenAt_*#(Instant frozenAt)` : `xref:system:generated:index/applib/clock/VirtualClock.adoc[VirtualClock]`
 +
 --
 Always returns the time _Instant_ as given by _frozenAt_
 --
-<.> `[teal]#*_frozenTestClock_*#()` : `xref:system:generated:index/applib/clock/VirtualClock.adoc.adoc[VirtualClock]`
+<.> `[teal]#*_frozenTestClock_*#()` : `xref:system:generated:index/applib/clock/VirtualClock.adoc[VirtualClock]`
 +
 --
 Always returns the time _Instant_ 2003/8/17 21:30:25 (UTC)
diff --git a/antora/components/system/modules/generated/pages/index/applib/events/domain/AbstractDomainEvent.adoc b/antora/components/system/modules/generated/pages/index/applib/events/domain/AbstractDomainEvent.adoc
index 8a6bd96..4d8f4e1 100644
--- a/antora/components/system/modules/generated/pages/index/applib/events/domain/AbstractDomainEvent.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/events/domain/AbstractDomainEvent.adoc
@@ -49,7 +49,7 @@ class AbstractDomainEvent {
 --
 If used then the framework will set state via (non-API) setters.
 
-Because the xref:system:generated:index/applib/events/EventObjectBase.adoc.adoc[EventObjectBase] superclass prohibits a null source, a dummy value is temporarily used.
+Because the xref:system:generated:index/applib/events/EventObjectBase.adoc[EventObjectBase] superclass prohibits a null source, a dummy value is temporarily used.
 --
 <.> `[teal]#*setMixedIn*#(Object mixedIn)` : `void`
 +
@@ -66,16 +66,16 @@ The subject of the event, which will be either the _#getSource() source_ for a r
 --
 Not API, set by the framework.
 --
-<.> `[teal]#*setIdentifier*#(xref:system:generated:index/applib/Identifier.adoc.adoc[Identifier] identifier)` : `void`
+<.> `[teal]#*setIdentifier*#(xref:system:generated:index/applib/Identifier.adoc[Identifier] identifier)` : `void`
 +
 --
 Not API, set by the framework if the no-arg constructor is used.
 --
 <.> `[teal]#*hide*#()` : `void`
 <.> `[teal]#*disable*#(String reason)` : `void`
-<.> `[teal]#*disable*#(xref:system:generated:index/applib/services/i18n/TranslatableString.adoc.adoc[TranslatableString] reason)` : `void`
+<.> `[teal]#*disable*#(xref:system:generated:index/applib/services/i18n/TranslatableString.adoc[TranslatableString] reason)` : `void`
 <.> `[teal]#*invalidate*#(String reason)` : `void`
-<.> `[teal]#*invalidate*#(xref:system:generated:index/applib/services/i18n/TranslatableString.adoc.adoc[TranslatableString] reason)` : `void`
+<.> `[teal]#*invalidate*#(xref:system:generated:index/applib/services/i18n/TranslatableString.adoc[TranslatableString] reason)` : `void`
 <.> `[teal]#*veto*#(String reason, Object... args)` : `void`
 +
 --
@@ -83,7 +83,7 @@ Use instead of _#hide()_ , _#disable(String)_ and _#invalidate(String)_ ; just d
 
 If hiding, just pass `null` for the parameter.
 --
-<.> `[teal]#*veto*#(xref:system:generated:index/applib/services/i18n/TranslatableString.adoc.adoc[TranslatableString] translatableReason)` : `void`
+<.> `[teal]#*veto*#(xref:system:generated:index/applib/services/i18n/TranslatableString.adoc[TranslatableString] translatableReason)` : `void`
 +
 --
 Use instead of _#hide()_ , _#disable(org.apache.isis.applib.services.i18n.TranslatableString)_ and _#invalidate(org.apache.isis.applib.services.i18n.TranslatableString)_ ; just delegates to appropriate vetoing method based upon the _#getEventPhase() phase_ .
diff --git a/antora/components/system/modules/generated/pages/index/applib/events/domain/ActionDomainEvent.adoc b/antora/components/system/modules/generated/pages/index/applib/events/domain/ActionDomainEvent.adoc
index ffef591..195b1f9 100644
--- a/antora/components/system/modules/generated/pages/index/applib/events/domain/ActionDomainEvent.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/events/domain/ActionDomainEvent.adoc
@@ -34,7 +34,7 @@ Recommended because it reduces the amount of boilerplate in the domain object cl
 --
 Set by the framework. Event subscribers can replace the value with some other value if they wish, though only in the _Phase#EXECUTED_ phase.
 --
-<.> `[teal]#*setSemantics*#(xref:system:generated:index/applib/annotation/SemanticsOf.adoc.adoc[SemanticsOf] semantics)` : `void`
+<.> `[teal]#*setSemantics*#(xref:system:generated:index/applib/annotation/SemanticsOf.adoc[SemanticsOf] semantics)` : `void`
 +
 --
 Not API - set by the framework.
diff --git a/antora/components/system/modules/generated/pages/index/applib/events/ui/TitleUiEvent.adoc b/antora/components/system/modules/generated/pages/index/applib/events/ui/TitleUiEvent.adoc
index 1f7c1d5..d01c31e 100644
--- a/antora/components/system/modules/generated/pages/index/applib/events/ui/TitleUiEvent.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/events/ui/TitleUiEvent.adoc
@@ -30,7 +30,7 @@ Because the _EventObject_ superclass prohibits a null source, a dummy value is t
 --
 For subscribers to call to provide a (non-translated) title for this object.
 --
-<.> `[teal]#*setTranslatableTitle*#(xref:system:generated:index/applib/services/i18n/TranslatableString.adoc.adoc[TranslatableString] translatableTitle)` : `void`
+<.> `[teal]#*setTranslatableTitle*#(xref:system:generated:index/applib/services/i18n/TranslatableString.adoc[TranslatableString] translatableTitle)` : `void`
 +
 --
 For subscribers to call to provide a translatable (i18n) title for this object.
diff --git a/antora/components/system/modules/generated/pages/index/applib/graph/tree/TreeNode.adoc b/antora/components/system/modules/generated/pages/index/applib/graph/tree/TreeNode.adoc
index d6b7115..d2bddc7 100644
--- a/antora/components/system/modules/generated/pages/index/applib/graph/tree/TreeNode.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/graph/tree/TreeNode.adoc
@@ -54,18 +54,18 @@ interface TreeNode {
 }
 ----
 
-<.> `[teal]#*getTreeState*#()` : `xref:system:generated:index/applib/graph/tree/TreeState.adoc.adoc[TreeState]`
-<.> `[teal]#*expand*#(xref:system:generated:index/applib/graph/tree/TreePath.adoc.adoc[TreePath]... treePaths)` : `void`
+<.> `[teal]#*getTreeState*#()` : `xref:system:generated:index/applib/graph/tree/TreeState.adoc[TreeState]`
+<.> `[teal]#*expand*#(xref:system:generated:index/applib/graph/tree/TreePath.adoc[TreePath]... treePaths)` : `void`
 +
 --
 Adds _treePaths_ to the set of expanded nodes, as held by this tree's shared state object.
 --
-<.> `[teal]#*collapse*#(xref:system:generated:index/applib/graph/tree/TreePath.adoc.adoc[TreePath]... treePaths)` : `void`
+<.> `[teal]#*collapse*#(xref:system:generated:index/applib/graph/tree/TreePath.adoc[TreePath]... treePaths)` : `void`
 +
 --
 Removes _treePaths_ from the set of expanded nodes, as held by this tree's shared state object.
 --
-<.> `[teal]#*_lazy_*#<T>(T node, Class<? extends TreeAdapter<T>> treeAdapterClass)` : `xref:system:generated:index/applib/graph/tree/TreeNode.adoc.adoc[TreeNode]<T>`
+<.> `[teal]#*_lazy_*#<T>(T node, Class<? extends TreeAdapter<T>> treeAdapterClass)` : `xref:system:generated:index/applib/graph/tree/TreeNode.adoc[TreeNode]<T>`
 +
 --
 Convenient shortcut.
diff --git a/antora/components/system/modules/generated/pages/index/applib/graph/tree/TreePath.adoc b/antora/components/system/modules/generated/pages/index/applib/graph/tree/TreePath.adoc
index f02fe1f..bcc3163 100644
--- a/antora/components/system/modules/generated/pages/index/applib/graph/tree/TreePath.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/graph/tree/TreePath.adoc
@@ -24,6 +24,6 @@ interface TreePath {
 }
 ----
 
-<.> `[teal]#*append*#(int indexWithinSiblings)` : `xref:system:generated:index/applib/graph/tree/TreePath.adoc.adoc[TreePath]`
-<.> `[teal]#*getParentIfAny*#()` : `xref:system:generated:index/applib/graph/tree/TreePath.adoc.adoc[TreePath]`
+<.> `[teal]#*append*#(int indexWithinSiblings)` : `xref:system:generated:index/applib/graph/tree/TreePath.adoc[TreePath]`
+<.> `[teal]#*getParentIfAny*#()` : `xref:system:generated:index/applib/graph/tree/TreePath.adoc[TreePath]`
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/query/Query.adoc b/antora/components/system/modules/generated/pages/index/applib/query/Query.adoc
index 6d23c3e..b954898 100644
--- a/antora/components/system/modules/generated/pages/index/applib/query/Query.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/query/Query.adoc
@@ -7,7 +7,7 @@ The implementations of these objects are be provided by the underlying persistor
 
 Implementations are expected to implement the _#getStart()_ and _#getCount()_ methods, which are used to support range / paging the data. Returned result sets are expected to start from index "start", and no more than "count" items are expected.
 
- *Note:* that not every object store will necessarily support this interface. In particular, the in-memory object store does not. For this, you can use the _Predicate_ interface to similar effect, for example in _RepositoryService#allMatches(Class, Predicate, long, long)_ ). Note that the predicate is applied within the xref:system:generated:index/applib/services/repository/RepositoryService.adoc.adoc[RepositoryService] (ie client-side) rather than being pushed back to the object store.
+ *Note:* that not every object store will necessarily support this interface. In particular, the in-memory object store does not. For this, you can use the _Predicate_ interface to similar effect, for example in _RepositoryService#allMatches(Class, Predicate, long, long)_ ). Note that the predicate is applied within the xref:system:generated:index/applib/services/repository/RepositoryService.adoc[RepositoryService] (ie client-side) rather than being pushed back to the object store.
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/query/QueryFindAllInstances.adoc b/antora/components/system/modules/generated/pages/index/applib/query/QueryFindAllInstances.adoc
index 4f615d6..5864dfc 100644
--- a/antora/components/system/modules/generated/pages/index/applib/query/QueryFindAllInstances.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/query/QueryFindAllInstances.adoc
@@ -1,7 +1,7 @@
 = QueryFindAllInstances : _class_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-Although implements xref:system:generated:index/applib/query/Query.adoc.adoc[Query] and thus is intended to be (and indeed is) _Serializable_ , it will be converted into a `PersistenceQuery` in the runtime for remoting purposes.
+Although implements xref:system:generated:index/applib/query/Query.adoc[Query] and thus is intended to be (and indeed is) _Serializable_ , it will be converted into a `PersistenceQuery` in the runtime for remoting purposes.
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/DomainChangeRecord.adoc b/antora/components/system/modules/generated/pages/index/applib/services/DomainChangeRecord.adoc
index be86b1e..bdedbbf 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/DomainChangeRecord.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/DomainChangeRecord.adoc
@@ -53,10 +53,10 @@ The time that the change occurred.
 --
 The object type of the domain object being changed.
 --
-<.> `[teal]#*getTarget*#()` : `xref:system:generated:index/applib/services/bookmark/Bookmark.adoc.adoc[Bookmark]`
+<.> `[teal]#*getTarget*#()` : `xref:system:generated:index/applib/services/bookmark/Bookmark.adoc[Bookmark]`
 +
 --
-The xref:system:generated:index/applib/services/bookmark/Bookmark.adoc.adoc[Bookmark] identifying the domain object that has changed.
+The xref:system:generated:index/applib/services/bookmark/Bookmark.adoc[Bookmark] identifying the domain object that has changed.
 --
 <.> `[teal]#*getTargetMember*#()` : `String`
 +
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/RepresentsInteractionMemberExecution.adoc b/antora/components/system/modules/generated/pages/index/applib/services/RepresentsInteractionMemberExecution.adoc
index 33bb265..d6eb750 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/RepresentsInteractionMemberExecution.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/RepresentsInteractionMemberExecution.adoc
@@ -1,7 +1,7 @@
 = RepresentsInteractionMemberExecution : _interface_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-Extends xref:system:generated:index/commons/having/HasUniqueId.adoc.adoc[HasUniqueId] , where the _HasUniqueId#getUniqueId()_ is interpreted as an interaction (cf _InteractionDto_ ) that has at least one member execution (cf _org.apache.isis.schema.ixn.v1.MemberExecutionDto_ ) and may (by way of xref:system:generated:index/applib/services/wrapper/WrapperFactory.adoc.adoc[WrapperFactory] ) contain several.
+Extends xref:system:generated:index/commons/having/HasUniqueId.adoc[HasUniqueId] , where the _HasUniqueId#getUniqueId()_ is interpreted as an interaction (cf _InteractionDto_ ) that has at least one member execution (cf _org.apache.isis.schema.ixn.v1.MemberExecutionDto_ ) and may (by way of xref:system:generated:index/applib/services/wrapper/WrapperFactory.adoc[WrapperFactory] ) contain several.
 
 Examples could include SPI services that persist published events and status messages.
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/bookmark/Bookmark.adoc b/antora/components/system/modules/generated/pages/index/applib/services/bookmark/Bookmark.adoc
index 3817330..7c0321d 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/bookmark/Bookmark.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/bookmark/Bookmark.adoc
@@ -26,7 +26,7 @@ class Bookmark {
 }
 ----
 
-<.> `[teal]#*_parse_*#(String str)` : `Optional<xref:system:generated:index/applib/services/bookmark/Bookmark.adoc.adoc[Bookmark]>`
+<.> `[teal]#*_parse_*#(String str)` : `Optional<xref:system:generated:index/applib/services/bookmark/Bookmark.adoc[Bookmark]>`
 +
 --
 Round-trip with _#toString()_ representation.
@@ -34,7 +34,7 @@ Round-trip with _#toString()_ representation.
 <.> `[teal]#*toString*#()` : `String`
 +
 --
-The canonical form of the xref:system:generated:index/applib/services/bookmark/Bookmark.adoc.adoc[Bookmark] , that is " _#getObjectType() objectType_ _#SEPARATOR_ _#getIdentifier()_ ".
+The canonical form of the xref:system:generated:index/applib/services/bookmark/Bookmark.adoc[Bookmark] , that is " _#getObjectType() objectType_ _#SEPARATOR_ _#getIdentifier()_ ".
 
 This is parseable by the _#parse(String)_ .
 --
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/bookmark/BookmarkService.adoc b/antora/components/system/modules/generated/pages/index/applib/services/bookmark/BookmarkService.adoc
index 3826146..5c4c4aa 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/bookmark/BookmarkService.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/bookmark/BookmarkService.adoc
@@ -22,30 +22,30 @@ interface BookmarkService {
 }
 ----
 
-<.> `[teal]#*bookmarkFor*#(Object domainObject)` : `xref:system:generated:index/applib/services/bookmark/Bookmark.adoc.adoc[Bookmark]`
+<.> `[teal]#*bookmarkFor*#(Object domainObject)` : `xref:system:generated:index/applib/services/bookmark/Bookmark.adoc[Bookmark]`
 +
 --
-Returns the xref:system:generated:index/applib/services/bookmark/Bookmark.adoc.adoc[Bookmark] for the given domain object.
+Returns the xref:system:generated:index/applib/services/bookmark/Bookmark.adoc[Bookmark] for the given domain object.
 
  *Note* : Not every domain object is bookmark-able: only entities, view models and services (NOT values or collections)
 --
-<.> `[teal]#*bookmarkForElseThrow*#(Object domainObject)` : `xref:system:generated:index/applib/services/bookmark/Bookmark.adoc.adoc[Bookmark]`
+<.> `[teal]#*bookmarkForElseThrow*#(Object domainObject)` : `xref:system:generated:index/applib/services/bookmark/Bookmark.adoc[Bookmark]`
 +
 --
-As per _#bookmarkFor(Object)_ , but requires that a non-null xref:system:generated:index/applib/services/bookmark/Bookmark.adoc.adoc[Bookmark] is returned.
+As per _#bookmarkFor(Object)_ , but requires that a non-null xref:system:generated:index/applib/services/bookmark/Bookmark.adoc[Bookmark] is returned.
 --
-<.> `[teal]#*bookmarkFor*#(Class<?> cls, String identifier)` : `xref:system:generated:index/applib/services/bookmark/Bookmark.adoc.adoc[Bookmark]`
+<.> `[teal]#*bookmarkFor*#(Class<?> cls, String identifier)` : `xref:system:generated:index/applib/services/bookmark/Bookmark.adoc[Bookmark]`
 +
 --
-Utility method that creates a xref:system:generated:index/applib/services/bookmark/Bookmark.adoc.adoc[Bookmark] from the constituent parts.
+Utility method that creates a xref:system:generated:index/applib/services/bookmark/Bookmark.adoc[Bookmark] from the constituent parts.
 --
-<.> `[teal]#*lookup*#(xref:system:generated:index/applib/services/bookmark/BookmarkHolder.adoc.adoc[BookmarkHolder] bookmarkHolder)` : `Object`
-<.> `[teal]#*lookup*#(xref:system:generated:index/applib/services/bookmark/Bookmark.adoc.adoc[Bookmark] bookmark)` : `Object`
+<.> `[teal]#*lookup*#(xref:system:generated:index/applib/services/bookmark/BookmarkHolder.adoc[BookmarkHolder] bookmarkHolder)` : `Object`
+<.> `[teal]#*lookup*#(xref:system:generated:index/applib/services/bookmark/Bookmark.adoc[Bookmark] bookmark)` : `Object`
 +
 --
 Reciprocal of _#bookmarkFor(Object)_
 --
-<.> `[teal]#*lookup*#<T>(xref:system:generated:index/applib/services/bookmark/Bookmark.adoc.adoc[Bookmark] bookmark, Class<T> cls)` : `T`
+<.> `[teal]#*lookup*#<T>(xref:system:generated:index/applib/services/bookmark/Bookmark.adoc[Bookmark] bookmark, Class<T> cls)` : `T`
 +
 --
 As _#lookup(Bookmark)_ , but down-casting to the specified type.
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/command/Command.adoc b/antora/components/system/modules/generated/pages/index/applib/services/command/Command.adoc
index 7e6310b..7f79709 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/command/Command.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/command/Command.adoc
@@ -5,11 +5,11 @@ Represents the _intention to_ invoke either an action or modify a property. Ther
 
 Each Command holds a _CommandDto_ (see Apache Isiscmdschema) which reifies all the details in a serializable form.
 
-It also captures details of the corresponding action invocation (or property edit), specifically when that action/edit _Command#getStartedAt() started_ or _Command#getCompletedAt() completed_ , and its result, either a _Command#getResult() return value_ or an _Command#getException() exception_ . Also captures a stack of xref:system:generated:index/applib/events/domain/ActionDomainEvent.adoc.adoc[ActionDomainEvent] s.
+It also captures details of the corresponding action invocation (or property edit), specifically when that action/edit _Command#getStartedAt() started_ or _Command#getCompletedAt() completed_ , and its result, either a _Command#getResult() return value_ or an _Command#getException() exception_ . Also captures a stack of xref:system:generated:index/applib/events/domain/ActionDomainEvent.adoc[ActionDomainEvent] s.
 
-Note that when invoking an action, other actions may be invoked courtesy of the xref:system:generated:index/applib/services/wrapper/WrapperFactory.adoc.adoc[WrapperFactory] . These "sub-actions" do _not_ modify the contents of the current command object; in other words think of the command object as representing the outer-most originating action.
+Note that when invoking an action, other actions may be invoked courtesy of the xref:system:generated:index/applib/services/wrapper/WrapperFactory.adoc[WrapperFactory] . These "sub-actions" do _not_ modify the contents of the current command object; in other words think of the command object as representing the outer-most originating action.
 
-That said, if the sub-action is invoked asynchronously (using _WrapperFactory#asyncWrap(Object, AsyncControl)_ or _WrapperFactory#asyncWrapMixin(Class, Object, AsyncControl)_ ), then a separate xref:system:generated:index/applib/services/command/Command.adoc.adoc[Command] object is created, and the originating xref:system:generated:index/applib/services/command/Command.adoc.adoc[Command] is set to be its _Command#getParent() parent_ .
+That said, if the sub-action is invoked asynchronously (using _WrapperFactory#asyncWrap(Object, AsyncControl)_ or _WrapperFactory#asyncWrapMixin(Class, Object, AsyncControl)_ ), then a separate xref:system:generated:index/applib/services/command/Command.adoc[Command] object is created, and the originating xref:system:generated:index/applib/services/command/Command.adoc[Command] is set to be its _Command#getParent() parent_ .
 
 .Java Sources
 [source,java]
@@ -42,10 +42,10 @@ The date/time at which this command was created.
 
 Derived from _#getCommandDto()_ 's _CommandDto#getTimestamp()_ .
 --
-<.> `[teal]#*getTarget*#()` : `xref:system:generated:index/applib/services/bookmark/Bookmark.adoc.adoc[Bookmark]`
+<.> `[teal]#*getTarget*#()` : `xref:system:generated:index/applib/services/bookmark/Bookmark.adoc[Bookmark]`
 +
 --
-Derived from _#getCommandDto()_ , is the xref:system:generated:index/applib/services/bookmark/Bookmark.adoc.adoc[Bookmark] of the target object (entity or service) on which this action/edit was performed.
+Derived from _#getCommandDto()_ , is the xref:system:generated:index/applib/services/bookmark/Bookmark.adoc[Bookmark] of the target object (entity or service) on which this action/edit was performed.
 --
 <.> `[teal]#*getLogicalMemberIdentifier*#()` : `String`
 +
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/command/CommandExecutorService.adoc b/antora/components/system/modules/generated/pages/index/applib/services/command/CommandExecutorService.adoc
index af456b7..a1fb582 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/command/CommandExecutorService.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/command/CommandExecutorService.adoc
@@ -16,7 +16,7 @@ interface CommandExecutorService {
 }
 ----
 
-<.> `[teal]#*executeCommand*#(SudoPolicy sudoPolicy, xref:system:generated:index/applib/services/command/Command.adoc.adoc[Command] command)` : `xref:system:generated:index/applib/services/bookmark/Bookmark.adoc.adoc[Bookmark]`
+<.> `[teal]#*executeCommand*#(SudoPolicy sudoPolicy, xref:system:generated:index/applib/services/command/Command.adoc[Command] command)` : `xref:system:generated:index/applib/services/bookmark/Bookmark.adoc[Bookmark]`
 +
 --
 Executes the specified command.
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/commanddto/conmap/ContentMappingServiceForCommandsDto.adoc b/antora/components/system/modules/generated/pages/index/applib/services/commanddto/conmap/ContentMappingServiceForCommandsDto.adoc
index 1b520c9..aa393e9 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/commanddto/conmap/ContentMappingServiceForCommandsDto.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/commanddto/conmap/ContentMappingServiceForCommandsDto.adoc
@@ -18,6 +18,6 @@ ContentMappingServiceForCommandDto contentMappingServiceForCommandDto;
 <.> `[teal]#*map*#(Object object)` : `CommandsDto`
 +
 --
-Not part of the xref:system:generated:index/applib/services/conmap/ContentMappingService.adoc.adoc[ContentMappingService] API.
+Not part of the xref:system:generated:index/applib/services/conmap/ContentMappingService.adoc[ContentMappingService] API.
 --
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/commanddto/processor/spi/CommandDtoProcessorService.adoc b/antora/components/system/modules/generated/pages/index/applib/services/commanddto/processor/spi/CommandDtoProcessorService.adoc
index e509918..7a75d4f 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/commanddto/processor/spi/CommandDtoProcessorService.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/commanddto/processor/spi/CommandDtoProcessorService.adoc
@@ -1,7 +1,7 @@
 = CommandDtoProcessorService : _interface_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-Optional SPI called by xref:system:generated:index/applib/services/commanddto/conmap/ContentMappingServiceForCommandDto.adoc.adoc[ContentMappingServiceForCommandDto] . Similar to xref:system:generated:index/applib/services/commanddto/processor/CommandDtoProcessor.adoc.adoc[CommandDtoProcessor] , but applied to all _CommandDto_ s globally.
+Optional SPI called by xref:system:generated:index/applib/services/commanddto/conmap/ContentMappingServiceForCommandDto.adoc[ContentMappingServiceForCommandDto] . Similar to xref:system:generated:index/applib/services/commanddto/processor/CommandDtoProcessor.adoc[CommandDtoProcessor] , but applied to all _CommandDto_ s globally.
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/confview/ConfigurationViewService.adoc b/antora/components/system/modules/generated/pages/index/applib/services/confview/ConfigurationViewService.adoc
index 4bf7ca9..79f9e67 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/confview/ConfigurationViewService.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/confview/ConfigurationViewService.adoc
@@ -10,9 +10,9 @@ interface ConfigurationViewService {
 }
 ----
 
-<.> `[teal]#*allProperties*#()` : `Set<xref:system:generated:index/applib/services/confview/ConfigurationProperty.adoc.adoc[ConfigurationProperty]>`
+<.> `[teal]#*allProperties*#()` : `Set<xref:system:generated:index/applib/services/confview/ConfigurationProperty.adoc[ConfigurationProperty]>`
 +
 --
-Returns all properties, each as an instance of xref:system:generated:index/applib/services/confview/ConfigurationProperty.adoc.adoc[ConfigurationProperty] (a view model). Mask sensitive values if required.
+Returns all properties, each as an instance of xref:system:generated:index/applib/services/confview/ConfigurationProperty.adoc[ConfigurationProperty] (a view model). Mask sensitive values if required.
 --
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/error/ErrorDetails.adoc b/antora/components/system/modules/generated/pages/index/applib/services/error/ErrorDetails.adoc
index 89a3db7..7227fbf 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/error/ErrorDetails.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/error/ErrorDetails.adoc
@@ -1,7 +1,7 @@
 = ErrorDetails : _class_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-Details of the error (obtained from the thrown exception), passed as part of the request to the xref:system:generated:index/applib/services/error/ErrorReportingService.adoc.adoc[ErrorReportingService] .
+Details of the error (obtained from the thrown exception), passed as part of the request to the xref:system:generated:index/applib/services/error/ErrorReportingService.adoc[ErrorReportingService] .
 
 Implementation note: a class has been used here so that additional fields might be added in the future.
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/error/Ticket.adoc b/antora/components/system/modules/generated/pages/index/applib/services/error/Ticket.adoc
index 08c2948..82330a7 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/error/Ticket.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/error/Ticket.adoc
@@ -1,7 +1,7 @@
 = Ticket : _interface_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-Response from the xref:system:generated:index/applib/services/error/ErrorReportingService.adoc.adoc[ErrorReportingService] , containing information to show to the end-user.
+Response from the xref:system:generated:index/applib/services/error/ErrorReportingService.adoc[ErrorReportingService] , containing information to show to the end-user.
 
 Implementation notes:
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/exceprecog/ExceptionRecognizer.adoc b/antora/components/system/modules/generated/pages/index/applib/services/exceprecog/ExceptionRecognizer.adoc
index 7206bcb..169cfa3 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/exceprecog/ExceptionRecognizer.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/exceprecog/ExceptionRecognizer.adoc
@@ -5,7 +5,7 @@ Domain service to (attempt) to recognize certain exceptions, and return user-fri
 
 Rather than redirecting to a general-purpose error page, the message (corresponding to the recognized exception) is rendered as a regular validation message.
 
-More than one implementation of xref:system:generated:index/applib/services/exceprecog/ExceptionRecognizer.adoc.adoc[ExceptionRecognizer] can be registered; they will all be consulted (in the order as specified by the @Order annotation) to determine if they recognize the exception. The message returned by the first service recognizing the exception is used.
+More than one implementation of xref:system:generated:index/applib/services/exceprecog/ExceptionRecognizer.adoc[ExceptionRecognizer] can be registered; they will all be consulted (in the order as specified by the @Order annotation) to determine if they recognize the exception. The message returned by the first service recognizing the exception is used.
 
 The Isis framework also provides a default implementation of this service that recognizes any _org.apache.isis.applib.RecoverableException_ , simply returning the exception's _org.apache.isis.applib.RecoverableException#getMessage() message_ . This allows any component or domain object to throw this exception with the knowledge that it will be handled appropriately.
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/exceprecog/ExceptionRecognizerService.adoc b/antora/components/system/modules/generated/pages/index/applib/services/exceprecog/ExceptionRecognizerService.adoc
index 6a36fd2..a11d862 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/exceprecog/ExceptionRecognizerService.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/exceprecog/ExceptionRecognizerService.adoc
@@ -14,13 +14,13 @@ interface ExceptionRecognizerService {
 }
 ----
 
-<.> `[teal]#*getExceptionRecognizers*#()` : `Can<xref:system:generated:index/applib/services/exceprecog/ExceptionRecognizer.adoc.adoc[ExceptionRecognizer]>`
+<.> `[teal]#*getExceptionRecognizers*#()` : `Can<xref:system:generated:index/applib/services/exceprecog/ExceptionRecognizer.adoc[ExceptionRecognizer]>`
 <.> `[teal]#*recognize*#(Exception ex)` : `Optional<Recognition>`
 +
 --
 Takes into consideration ExceptionRecognizers as given by _#getExceptionRecognizers()_ .
 --
-<.> `[teal]#*recognizeFromSelected*#(Can<xref:system:generated:index/applib/services/exceprecog/ExceptionRecognizer.adoc.adoc[ExceptionRecognizer]> recognizers, Exception ex)` : `Optional<Recognition>`
+<.> `[teal]#*recognizeFromSelected*#(Can<xref:system:generated:index/applib/services/exceprecog/ExceptionRecognizer.adoc[ExceptionRecognizer]> recognizers, Exception ex)` : `Optional<Recognition>`
 +
 --
 Takes into consideration ExceptionRecognizers as given by _recognizers_ .
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/exceprecog/TranslatableException.adoc b/antora/components/system/modules/generated/pages/index/applib/services/exceprecog/TranslatableException.adoc
index a0d31e7..cb10445 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/exceprecog/TranslatableException.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/exceprecog/TranslatableException.adoc
@@ -16,7 +16,7 @@ interface TranslatableException {
 }
 ----
 
-<.> `[teal]#*getTranslatableMessage*#()` : `xref:system:generated:index/applib/services/i18n/TranslatableString.adoc.adoc[TranslatableString]`
+<.> `[teal]#*getTranslatableMessage*#()` : `xref:system:generated:index/applib/services/i18n/TranslatableString.adoc[TranslatableString]`
 +
 --
 In the spirit of _Exception#getLocalizedMessage()_ , but using _org.apache.isis.applib.services.i18n.TranslatableString_ instead.
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/grid/GridService.adoc b/antora/components/system/modules/generated/pages/index/applib/services/grid/GridService.adoc
index 35da5cb..2da9b24 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/grid/GridService.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/grid/GridService.adoc
@@ -61,20 +61,20 @@ Returns a default grid; eg where none can be loaded using _#load(Class)_ .
 --
 Returns a normalized grid for the domain class obtained previously using _#load(Class)_ .
 
-If a "normalized" grid is persisted as thelayout.xml, then the expectation is that the xref:system:generated:index/applib/annotation/MemberOrder.adoc.adoc[MemberOrder] annotation can be removed from the domain class because the binding of properties/collections/actions will be within the XML. However, the layout annotations ( xref:system:generated:index/applib/annotation/DomainObjectLayout.adoc.adoc[DomainObjectLayout] , xref:system:generated:index/applib/annotation/ActionLayout.adoc.ado [...]
+If a "normalized" grid is persisted as thelayout.xml, then the expectation is that the xref:system:generated:index/applib/annotation/MemberOrder.adoc[MemberOrder] annotation can be removed from the domain class because the binding of properties/collections/actions will be within the XML. However, the layout annotations ( xref:system:generated:index/applib/annotation/DomainObjectLayout.adoc[DomainObjectLayout] , xref:system:generated:index/applib/annotation/ActionLayout.adoc[ActionLayout] [...]
 --
 <.> `[teal]#*complete*#(Grid grid)` : `Grid`
 +
 --
-Modifies the provided _Grid_ with additional metadata, broadly speaking corresponding to the xref:system:generated:index/applib/annotation/DomainObjectLayout.adoc.adoc[DomainObjectLayout] , xref:system:generated:index/applib/annotation/ActionLayout.adoc.adoc[ActionLayout] , xref:system:generated:index/applib/annotation/PropertyLayout.adoc.adoc[PropertyLayout] and xref:system:generated:index/applib/annotation/CollectionLayout.adoc.adoc[CollectionLayout] .
+Modifies the provided _Grid_ with additional metadata, broadly speaking corresponding to the xref:system:generated:index/applib/annotation/DomainObjectLayout.adoc[DomainObjectLayout] , xref:system:generated:index/applib/annotation/ActionLayout.adoc[ActionLayout] , xref:system:generated:index/applib/annotation/PropertyLayout.adoc[PropertyLayout] and xref:system:generated:index/applib/annotation/CollectionLayout.adoc[CollectionLayout] .
 
-If a "completed" grid is persisted as thelayout.xml, then there should be no need for any of the layout annotations, nor the xref:system:generated:index/applib/annotation/MemberOrder.adoc.adoc[MemberOrder] annotations, to be required in the domain class itself.
+If a "completed" grid is persisted as thelayout.xml, then there should be no need for any of the layout annotations, nor the xref:system:generated:index/applib/annotation/MemberOrder.adoc[MemberOrder] annotations, to be required in the domain class itself.
 --
 <.> `[teal]#*minimal*#(Grid grid)` : `Grid`
 +
 --
 Modifies the provided _Grid_ , removing all metadata except the basic grid structure.
 
-If a "minimal" grid is persisted as thelayout.xml, then the expectation is that most of the layout annotations ( xref:system:generated:index/applib/annotation/DomainObjectLayout.adoc.adoc[DomainObjectLayout] , xref:system:generated:index/applib/annotation/ActionLayout.adoc.adoc[ActionLayout] , xref:system:generated:index/applib/annotation/PropertyLayout.adoc.adoc[PropertyLayout] , xref:system:generated:index/applib/annotation/CollectionLayout.adoc.adoc[CollectionLayout] , but also xref:s [...]
+If a "minimal" grid is persisted as thelayout.xml, then the expectation is that most of the layout annotations ( xref:system:generated:index/applib/annotation/DomainObjectLayout.adoc[DomainObjectLayout] , xref:system:generated:index/applib/annotation/ActionLayout.adoc[ActionLayout] , xref:system:generated:index/applib/annotation/PropertyLayout.adoc[PropertyLayout] , xref:system:generated:index/applib/annotation/CollectionLayout.adoc[CollectionLayout] , but also xref:system:generated:inde [...]
 --
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/homepage/HomePageResolverService.adoc b/antora/components/system/modules/generated/pages/index/applib/services/homepage/HomePageResolverService.adoc
index cc1ada4..e87ee7c 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/homepage/HomePageResolverService.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/homepage/HomePageResolverService.adoc
@@ -1,7 +1,7 @@
 = HomePageResolverService : _interface_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-Returns a view model annotated with xref:system:generated:index/applib/annotation/HomePage.adoc.adoc[HomePage] .
+Returns a view model annotated with xref:system:generated:index/applib/annotation/HomePage.adoc[HomePage] .
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/i18n/TranslatableString.adoc b/antora/components/system/modules/generated/pages/index/applib/services/i18n/TranslatableString.adoc
index 4822a13..1090195 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/i18n/TranslatableString.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/i18n/TranslatableString.adoc
@@ -34,12 +34,12 @@ class TranslatableString {
 }
 ----
 
-<.> `[teal]#*_tr_*#(String pattern, Object... paramArgs)` : `xref:system:generated:index/applib/services/i18n/TranslatableString.adoc.adoc[TranslatableString]`
+<.> `[teal]#*_tr_*#(String pattern, Object... paramArgs)` : `xref:system:generated:index/applib/services/i18n/TranslatableString.adoc[TranslatableString]`
 +
 --
 A translatable string with a single pattern for both singular and plural forms.
 --
-<.> `[teal]#*_trn_*#(String singularPattern, String pluralPattern, int number, Object... paramArgs)` : `xref:system:generated:index/applib/services/i18n/TranslatableString.adoc.adoc[TranslatableString]`
+<.> `[teal]#*_trn_*#(String singularPattern, String pluralPattern, int number, Object... paramArgs)` : `xref:system:generated:index/applib/services/i18n/TranslatableString.adoc[TranslatableString]`
 +
 --
 A translatable string with different patterns for singular and plural forms, selected automatically by the number
@@ -59,7 +59,7 @@ The plural text as provided in the _#trn(String, String, int, Object...) factory
 --
 The arguments; excluded from _#equals(Object)_ comparison.
 --
-<.> `[teal]#*translate*#(xref:system:generated:index/applib/services/i18n/TranslationService.adoc.adoc[TranslationService] translationService, String context)` : `String`
+<.> `[teal]#*translate*#(xref:system:generated:index/applib/services/i18n/TranslationService.adoc[TranslationService] translationService, String context)` : `String`
 +
 --
 Translates this string using the provided _org.apache.isis.applib.services.i18n.TranslationService_ , selecting either the single or plural form as per _#getPattern()_ .
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/iactn/ExecutionContext.adoc b/antora/components/system/modules/generated/pages/index/applib/services/iactn/ExecutionContext.adoc
index caf8ea7..fb1c5cf 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/iactn/ExecutionContext.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/iactn/ExecutionContext.adoc
@@ -12,9 +12,9 @@ class ExecutionContext {
 }
 ----
 
-<.> `[teal]#*_ofUserWithSystemDefaults_*#(xref:system:generated:index/applib/services/user/UserMemento.adoc.adoc[UserMemento] user)` : `xref:system:generated:index/applib/services/iactn/ExecutionContext.adoc.adoc[ExecutionContext]`
+<.> `[teal]#*_ofUserWithSystemDefaults_*#(xref:system:generated:index/applib/services/user/UserMemento.adoc[UserMemento] user)` : `xref:system:generated:index/applib/services/iactn/ExecutionContext.adoc[ExecutionContext]`
 +
 --
-Creates a new xref:system:generated:index/applib/services/iactn/ExecutionContext.adoc.adoc[ExecutionContext] with the specified user and system defaults for clock, locale and time-zone.
+Creates a new xref:system:generated:index/applib/services/iactn/ExecutionContext.adoc[ExecutionContext] with the specified user and system defaults for clock, locale and time-zone.
 --
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/iactn/Interaction.adoc b/antora/components/system/modules/generated/pages/index/applib/services/iactn/Interaction.adoc
index 5a34eb8..570945d 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/iactn/Interaction.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/iactn/Interaction.adoc
@@ -3,11 +3,11 @@
 
 Represents an action invocation or property modification, resulting in some state change of the system. It captures not only the target object and arguments passed, but also builds up the call-graph, and captures metrics, eg for profiling.
 
-The distinction between xref:system:generated:index/applib/services/command/Command.adoc.adoc[Command] and this object is perhaps subtle: the former represents the intention to invoke an action/edit a property, whereas this represents the actual invocation/edit itself.
+The distinction between xref:system:generated:index/applib/services/command/Command.adoc[Command] and this object is perhaps subtle: the former represents the intention to invoke an action/edit a property, whereas this represents the actual invocation/edit itself.
 
-To confuse matters slightly, historically the xref:system:generated:index/applib/services/command/Command.adoc.adoc[Command] interface defines members (specifically: _Command#getStartedAt()_ , _Command#getCompletedAt()_ , _Command#getResult()_ , _Command#getException()_ ) which logically belong to this class instead; they remain in xref:system:generated:index/applib/services/command/Command.adoc.adoc[Command] for backward compatibility only (and have been deprecated).
+To confuse matters slightly, historically the xref:system:generated:index/applib/services/command/Command.adoc[Command] interface defines members (specifically: _Command#getStartedAt()_ , _Command#getCompletedAt()_ , _Command#getResult()_ , _Command#getException()_ ) which logically belong to this class instead; they remain in xref:system:generated:index/applib/services/command/Command.adoc[Command] for backward compatibility only (and have been deprecated).
 
-NOTE: you could also think of this interface as being analogous to the (database) transaction. The name "Transaction" has not been used for the interface not chosen however because there is also the system-level transaction that manages the persistence of the xref:system:generated:index/applib/services/command/Command.adoc.adoc[Command] object itself.
+NOTE: you could also think of this interface as being analogous to the (database) transaction. The name "Transaction" has not been used for the interface not chosen however because there is also the system-level transaction that manages the persistence of the xref:system:generated:index/applib/services/command/Command.adoc[Command] object itself.
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/iactn/InteractionContext.adoc b/antora/components/system/modules/generated/pages/index/applib/services/iactn/InteractionContext.adoc
index 04c5d00..c7b19641 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/iactn/InteractionContext.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/iactn/InteractionContext.adoc
@@ -1,7 +1,7 @@
 = InteractionContext : _interface_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-Provides the current thread's xref:system:generated:index/applib/services/iactn/Interaction.adoc.adoc[Interaction] .
+Provides the current thread's xref:system:generated:index/applib/services/iactn/Interaction.adoc[Interaction] .
 
 .Java Sources
 [source,java]
@@ -14,9 +14,9 @@ interface InteractionContext {
 }
 ----
 
-<.> `[teal]#*currentInteraction*#()` : `Optional<xref:system:generated:index/applib/services/iactn/Interaction.adoc.adoc[Interaction]>`
+<.> `[teal]#*currentInteraction*#()` : `Optional<xref:system:generated:index/applib/services/iactn/Interaction.adoc[Interaction]>`
 +
 --
-Optionally, the currently active xref:system:generated:index/applib/services/iactn/Interaction.adoc.adoc[Interaction] for the calling thread.
+Optionally, the currently active xref:system:generated:index/applib/services/iactn/Interaction.adoc[Interaction] for the calling thread.
 --
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/layout/LayoutService.adoc b/antora/components/system/modules/generated/pages/index/applib/services/layout/LayoutService.adoc
index 175bd46..1517344 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/layout/LayoutService.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/layout/LayoutService.adoc
@@ -27,6 +27,6 @@ Obtains a zip file of the serialized XML of the layouts (grids) of all domain en
 <.> `[teal]#*toMenuBarsXml*#(Type type)` : `String`
 +
 --
-Obtains the serialized XML form of the menu bars layout ( xref:system:generated:index/applib/services/menu/MenuBarsService.adoc.adoc[MenuBarsService] ).
+Obtains the serialized XML form of the menu bars layout ( xref:system:generated:index/applib/services/menu/MenuBarsService.adoc[MenuBarsService] ).
 --
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/message/MessageService.adoc b/antora/components/system/modules/generated/pages/index/applib/services/message/MessageService.adoc
index 35531ca..e2f2f8d 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/message/MessageService.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/message/MessageService.adoc
@@ -31,14 +31,14 @@ interface MessageService {
 --
 Make the specified message available to the user. Note this will probably be displayed in transitory fashion, so is only suitable for useful but optional information.
 --
-<.> `[teal]#*informUser*#(xref:system:generated:index/applib/services/i18n/TranslatableString.adoc.adoc[TranslatableString] message, Class<?> contextClass, String contextMethod)` : `String`
+<.> `[teal]#*informUser*#(xref:system:generated:index/applib/services/i18n/TranslatableString.adoc[TranslatableString] message, Class<?> contextClass, String contextMethod)` : `String`
 +
 --
 Make the specified message available to the user, translated (if possible) to user's locale.
 
 More precisely, the locale is as provided by the configured _org.apache.isis.applib.services.i18n.LocaleProvider_ service. This will most commonly be the locale of the current request (ie the current user's locale).
 --
-<.> `[teal]#*informUser*#(xref:system:generated:index/applib/services/i18n/TranslatableString.adoc.adoc[TranslatableString] message, String translationContext)` : `String`
+<.> `[teal]#*informUser*#(xref:system:generated:index/applib/services/i18n/TranslatableString.adoc[TranslatableString] message, String translationContext)` : `String`
 +
 --
 Override of _MessageService#informUser(TranslatableString, Class, String)_ , but with last two parameters combined into a context string.
@@ -48,14 +48,14 @@ Override of _MessageService#informUser(TranslatableString, Class, String)_ , but
 --
 Warn the user about a situation with the specified message. The container should guarantee to display this warning to the user, and will typically require acknowledgement.
 --
-<.> `[teal]#*warnUser*#(xref:system:generated:index/applib/services/i18n/TranslatableString.adoc.adoc[TranslatableString] message, Class<?> contextClass, String contextMethod)` : `String`
+<.> `[teal]#*warnUser*#(xref:system:generated:index/applib/services/i18n/TranslatableString.adoc[TranslatableString] message, Class<?> contextClass, String contextMethod)` : `String`
 +
 --
 Warn the user about a situation with the specified message, translated (if possible) to user's locale.
 
 More precisely, the locale is as provided by the configured _org.apache.isis.applib.services.i18n.LocaleProvider_ service. This will most commonly be the locale of the current request (ie the current user's locale).
 --
-<.> `[teal]#*warnUser*#(xref:system:generated:index/applib/services/i18n/TranslatableString.adoc.adoc[TranslatableString] message, String translationContext)` : `String`
+<.> `[teal]#*warnUser*#(xref:system:generated:index/applib/services/i18n/TranslatableString.adoc[TranslatableString] message, String translationContext)` : `String`
 +
 --
 Override of _MessageService#warnUser(TranslatableString, Class, String)_ , but with last two parameters combined into a context string.
@@ -65,14 +65,14 @@ Override of _MessageService#warnUser(TranslatableString, Class, String)_ , but w
 --
 Notify the user of an application error with the specified message. Note this will probably be displayed in an alarming fashion, so is only suitable for errors. The user will typically be required to perform additional steps after the error (eg to inform the helpdesk).
 --
-<.> `[teal]#*raiseError*#(xref:system:generated:index/applib/services/i18n/TranslatableString.adoc.adoc[TranslatableString] message, Class<?> contextClass, String contextMethod)` : `String`
+<.> `[teal]#*raiseError*#(xref:system:generated:index/applib/services/i18n/TranslatableString.adoc[TranslatableString] message, Class<?> contextClass, String contextMethod)` : `String`
 +
 --
 Notify the user of an application error with the specified message, translated (if possible) to user's locale.
 
 More precisely, the locale is as provided by the configured _org.apache.isis.applib.services.i18n.LocaleProvider_ service. This will most commonly be the locale of the current request (ie the current user's locale).
 --
-<.> `[teal]#*raiseError*#(xref:system:generated:index/applib/services/i18n/TranslatableString.adoc.adoc[TranslatableString] message, String translationContext)` : `String`
+<.> `[teal]#*raiseError*#(xref:system:generated:index/applib/services/i18n/TranslatableString.adoc[TranslatableString] message, String translationContext)` : `String`
 +
 --
 Override of _MessageService#raiseError(TranslatableString, Class, String)_ , but with last two parameters combined into a context string.
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/metamodel/MetaModelService.adoc b/antora/components/system/modules/generated/pages/index/applib/services/metamodel/MetaModelService.adoc
index 45d5428..985778c 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/metamodel/MetaModelService.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/metamodel/MetaModelService.adoc
@@ -38,12 +38,12 @@ Provides a reverse lookup of a domain class' object type, as defined by _DomainO
 --
 Provides a lookup of a domain class' object type, as defined by _DomainObject#objectType()_ (or any other mechanism that corresponds to Isis'ObjectSpecIdFacet).
 --
-<.> `[teal]#*getDomainModel*#()` : `xref:system:generated:index/applib/services/metamodel/DomainModel.adoc.adoc[DomainModel]`
+<.> `[teal]#*getDomainModel*#()` : `xref:system:generated:index/applib/services/metamodel/DomainModel.adoc[DomainModel]`
 +
 --
 Returns a list of representations of each of member of each domain class.
 
-Used by xref:system:generated:index/applib/services/metamodel/MetaModelServiceMenu.adoc.adoc[MetaModelServiceMenu] to return a downloadable CSV.
+Used by xref:system:generated:index/applib/services/metamodel/MetaModelServiceMenu.adoc[MetaModelServiceMenu] to return a downloadable CSV.
 
 Note that _MetaModelService#exportMetaModel(Config)_ provides a superset of the functionality provided by this method.
 --
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/publishing/spi/CommandSubscriber.adoc b/antora/components/system/modules/generated/pages/index/applib/services/publishing/spi/CommandSubscriber.adoc
index 44a48b4..27e3106 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/publishing/spi/CommandSubscriber.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/publishing/spi/CommandSubscriber.adoc
@@ -1,7 +1,7 @@
 = CommandSubscriber : _interface_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-Part of the _Publishing SPI_ . A component to receive xref:system:generated:index/applib/services/command/Command.adoc.adoc[Command] s (with publishing enabled) that just completed.
+Part of the _Publishing SPI_ . A component to receive xref:system:generated:index/applib/services/command/Command.adoc[Command] s (with publishing enabled) that just completed.
 
 .Java Sources
 [source,java]
@@ -12,7 +12,7 @@ interface CommandSubscriber {
 }
 ----
 
-<.> `[teal]#*onCompleted*#(xref:system:generated:index/applib/services/command/Command.adoc.adoc[Command] command)` : `void`
+<.> `[teal]#*onCompleted*#(xref:system:generated:index/applib/services/command/Command.adoc[Command] command)` : `void`
 +
 --
 Notifies that the command has completed.
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/publishing/spi/EntityChangesSubscriber.adoc b/antora/components/system/modules/generated/pages/index/applib/services/publishing/spi/EntityChangesSubscriber.adoc
index c16e858..0bc0185 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/publishing/spi/EntityChangesSubscriber.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/publishing/spi/EntityChangesSubscriber.adoc
@@ -12,7 +12,7 @@ interface EntityChangesSubscriber {
 }
 ----
 
-<.> `[teal]#*onChanging*#(xref:system:generated:index/applib/services/publishing/spi/EntityChanges.adoc.adoc[EntityChanges] entityChanges)` : `void`
+<.> `[teal]#*onChanging*#(xref:system:generated:index/applib/services/publishing/spi/EntityChanges.adoc[EntityChanges] entityChanges)` : `void`
 +
 --
 Receives all changing entities (with publishing enabled) at then end of the a transaction during the pre-commit phase.
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/publishing/spi/EntityPropertyChange.adoc b/antora/components/system/modules/generated/pages/index/applib/services/publishing/spi/EntityPropertyChange.adoc
index 1f6e2c9..98310a4 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/publishing/spi/EntityPropertyChange.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/publishing/spi/EntityPropertyChange.adoc
@@ -1,7 +1,7 @@
 = EntityPropertyChange : _class_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-Immutable data record for xref:system:generated:index/applib/services/publishing/spi/EntityPropertyChangeSubscriber.adoc.adoc[EntityPropertyChangeSubscriber] s.
+Immutable data record for xref:system:generated:index/applib/services/publishing/spi/EntityPropertyChangeSubscriber.adoc[EntityPropertyChangeSubscriber] s.
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/publishing/spi/EntityPropertyChangeSubscriber.adoc b/antora/components/system/modules/generated/pages/index/applib/services/publishing/spi/EntityPropertyChangeSubscriber.adoc
index 26a90be..3cb6789 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/publishing/spi/EntityPropertyChangeSubscriber.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/publishing/spi/EntityPropertyChangeSubscriber.adoc
@@ -12,7 +12,7 @@ interface EntityPropertyChangeSubscriber {
 }
 ----
 
-<.> `[teal]#*onChanging*#(xref:system:generated:index/applib/services/publishing/spi/EntityPropertyChange.adoc.adoc[EntityPropertyChange] entityPropertyChange)` : `void`
+<.> `[teal]#*onChanging*#(xref:system:generated:index/applib/services/publishing/spi/EntityPropertyChange.adoc[EntityPropertyChange] entityPropertyChange)` : `void`
 +
 --
 Receives all pre-post property values for entities (with publishing enabled) at then end of the transaction during the pre-commit phase.
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/repository/RepositoryService.adoc b/antora/components/system/modules/generated/pages/index/applib/services/repository/RepositoryService.adoc
index fd7233c..9a14d0b 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/repository/RepositoryService.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/repository/RepositoryService.adoc
@@ -52,7 +52,7 @@ interface RepositoryService {
 }
 ----
 
-<.> `[teal]#*getEntityState*#(Object object)` : `xref:system:generated:index/applib/services/repository/EntityState.adoc.adoc[EntityState]`
+<.> `[teal]#*getEntityState*#(Object object)` : `xref:system:generated:index/applib/services/repository/EntityState.adoc[EntityState]`
 +
 --
 Returns the EntityState of given _object_ . Returns _EntityState#NOT_PERSISTABLE_ for _object==null_ .
@@ -117,10 +117,10 @@ If there are no instances the list will be empty. This method creates a new _Lis
 
 This method is useful during exploration/prototyping, but - because the filtering is performed client-side - this method is only really suitable for initial development/prototyping, or for classes with very few instances. Use _#allMatches(Query)_ for production code.
 --
-<.> `[teal]#*allMatches*#<T>(xref:system:generated:index/applib/query/Query.adoc.adoc[Query]<T> query)` : `List<T>`
+<.> `[teal]#*allMatches*#<T>(xref:system:generated:index/applib/query/Query.adoc[Query]<T> query)` : `List<T>`
 +
 --
-Returns all the instances that match the given xref:system:generated:index/applib/query/Query.adoc.adoc[Query] .
+Returns all the instances that match the given xref:system:generated:index/applib/query/Query.adoc[Query] .
 
 If there are no instances the list will be empty. This method creates a new _List_ object each time it is called so the caller is free to use or modify the returned _List_ , but the changes will not be reflected back to the repository.
 
@@ -135,7 +135,7 @@ If no instance is found then _Optional#empty()_ will be return, while if there i
 
 This method is useful during exploration/prototyping, but - because the filtering is performed client-side - this method is only really suitable for initial development/prototyping, or for classes with very few instances. Use _#uniqueMatch(Query)_ for production code.
 --
-<.> `[teal]#*uniqueMatch*#<T>(xref:system:generated:index/applib/query/Query.adoc.adoc[Query]<T> query)` : `Optional<T>`
+<.> `[teal]#*uniqueMatch*#<T>(xref:system:generated:index/applib/query/Query.adoc[Query]<T> query)` : `Optional<T>`
 +
 --
 Find the only instance that matches the provided query.
@@ -153,7 +153,7 @@ If no instance is found then _Optional#empty()_ will be return, while if there i
 
 This method is useful during exploration/prototyping, but - because the filtering is performed client-side - this method is only really suitable for initial development/prototyping, or for classes with very few instances. Use _#firstMatch(Query)_ for production code.
 --
-<.> `[teal]#*firstMatch*#<T>(xref:system:generated:index/applib/query/Query.adoc.adoc[Query]<T> query)` : `Optional<T>`
+<.> `[teal]#*firstMatch*#<T>(xref:system:generated:index/applib/query/Query.adoc[Query]<T> query)` : `Optional<T>`
 +
 --
 Find the only instance that matches the provided query, if any..
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/sudo/SudoService.adoc b/antora/components/system/modules/generated/pages/index/applib/services/sudo/SudoService.adoc
index d8250e3..97bce57 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/sudo/SudoService.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/sudo/SudoService.adoc
@@ -1,7 +1,7 @@
 = SudoService : _interface_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-Intended only for use by fixture scripts and integration tests, allows a block of code to execute while the xref:system:generated:index/applib/services/user/UserService.adoc.adoc[UserService] 's _UserService#currentUser() getUser()_ method returns the specified user/role as the effective user.
+Intended only for use by fixture scripts and integration tests, allows a block of code to execute while the xref:system:generated:index/applib/services/user/UserService.adoc[UserService] 's _UserService#currentUser() getUser()_ method returns the specified user/role as the effective user.
 
 .Java Sources
 [source,java]
@@ -16,19 +16,19 @@ interface SudoService {
 }
 ----
 
-<.> `[teal]#*ACCESS_ALL_ROLE*#` : `xref:system:generated:index/applib/services/user/RoleMemento.adoc.adoc[RoleMemento]`
+<.> `[teal]#*ACCESS_ALL_ROLE*#` : `xref:system:generated:index/applib/services/user/RoleMemento.adoc[RoleMemento]`
 +
 --
 If included in the list of roles, then will disable security checks (can view and use all object members).
 --
-<.> `[teal]#*call*#<T>(UnaryOperator<xref:system:generated:index/applib/services/iactn/ExecutionContext.adoc.adoc[ExecutionContext]> sudoMapper, Callable<T> supplier)` : `T`
+<.> `[teal]#*call*#<T>(UnaryOperator<xref:system:generated:index/applib/services/iactn/ExecutionContext.adoc[ExecutionContext]> sudoMapper, Callable<T> supplier)` : `T`
 +
 --
-Executes the supplied block, with the xref:system:generated:index/applib/services/user/UserService.adoc.adoc[UserService] returning the specified user.
+Executes the supplied block, with the xref:system:generated:index/applib/services/user/UserService.adoc[UserService] returning the specified user.
 --
-<.> `[teal]#*run*#(UnaryOperator<xref:system:generated:index/applib/services/iactn/ExecutionContext.adoc.adoc[ExecutionContext]> sudoMapper, ThrowingRunnable runnable)` : `void`
+<.> `[teal]#*run*#(UnaryOperator<xref:system:generated:index/applib/services/iactn/ExecutionContext.adoc[ExecutionContext]> sudoMapper, ThrowingRunnable runnable)` : `void`
 +
 --
-Executes the supplied block, with the xref:system:generated:index/applib/services/user/UserService.adoc.adoc[UserService] returning the specified user.
+Executes the supplied block, with the xref:system:generated:index/applib/services/user/UserService.adoc[UserService] returning the specified user.
 --
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/user/RoleMemento.adoc b/antora/components/system/modules/generated/pages/index/applib/services/user/RoleMemento.adoc
index d864dde..cb4274c 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/user/RoleMemento.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/user/RoleMemento.adoc
@@ -1,7 +1,7 @@
 = RoleMemento : _class_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-Immutable serializable value held by xref:system:generated:index/applib/services/user/UserMemento.adoc.adoc[UserMemento] .
+Immutable serializable value held by xref:system:generated:index/applib/services/user/UserMemento.adoc[UserMemento] .
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/user/UserMemento.adoc b/antora/components/system/modules/generated/pages/index/applib/services/user/UserMemento.adoc
index 0990aa2..117dd65 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/user/UserMemento.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/user/UserMemento.adoc
@@ -38,32 +38,32 @@ class UserMemento {
 }
 ----
 
-<.> `[teal]#*UserMemento*#(String name, Stream<xref:system:generated:index/applib/services/user/RoleMemento.adoc.adoc[RoleMemento]> roles)`
+<.> `[teal]#*UserMemento*#(String name, Stream<xref:system:generated:index/applib/services/user/RoleMemento.adoc[RoleMemento]> roles)`
 +
 --
 Creates a new user with the specified name and assigned roles.
 --
-<.> `[teal]#*_system_*#()` : `xref:system:generated:index/applib/services/user/UserMemento.adoc.adoc[UserMemento]`
+<.> `[teal]#*_system_*#()` : `xref:system:generated:index/applib/services/user/UserMemento.adoc[UserMemento]`
 +
 --
 The framework's internal user with unrestricted privileges.
 --
-<.> `[teal]#*_ofName_*#(String name)` : `xref:system:generated:index/applib/services/user/UserMemento.adoc.adoc[UserMemento]`
+<.> `[teal]#*_ofName_*#(String name)` : `xref:system:generated:index/applib/services/user/UserMemento.adoc[UserMemento]`
 +
 --
 Creates a new user with the specified name and no roles.
 --
-<.> `[teal]#*_ofNameAndRoles_*#(String name, xref:system:generated:index/applib/services/user/RoleMemento.adoc.adoc[RoleMemento]... roles)` : `xref:system:generated:index/applib/services/user/UserMemento.adoc.adoc[UserMemento]`
+<.> `[teal]#*_ofNameAndRoles_*#(String name, xref:system:generated:index/applib/services/user/RoleMemento.adoc[RoleMemento]... roles)` : `xref:system:generated:index/applib/services/user/UserMemento.adoc[UserMemento]`
 +
 --
 Creates a new user with the specified name and assigned roles.
 --
-<.> `[teal]#*_ofNameAndRoleNames_*#(String name, String... roleNames)` : `xref:system:generated:index/applib/services/user/UserMemento.adoc.adoc[UserMemento]`
+<.> `[teal]#*_ofNameAndRoleNames_*#(String name, String... roleNames)` : `xref:system:generated:index/applib/services/user/UserMemento.adoc[UserMemento]`
 +
 --
 Creates a new user with the specified name and assigned role names.
 --
-<.> `[teal]#*_ofNameAndRoleNames_*#(String name, Stream<String> roleNames)` : `xref:system:generated:index/applib/services/user/UserMemento.adoc.adoc[UserMemento]`
+<.> `[teal]#*_ofNameAndRoleNames_*#(String name, Stream<String> roleNames)` : `xref:system:generated:index/applib/services/user/UserMemento.adoc[UserMemento]`
 +
 --
 Creates a new user with the specified name and assigned role names.
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/user/UserService.adoc b/antora/components/system/modules/generated/pages/index/applib/services/user/UserService.adoc
index e5292a6..b4f2b89 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/user/UserService.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/user/UserService.adoc
@@ -1,9 +1,9 @@
 = UserService : _interface_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-The xref:system:generated:index/applib/services/user/UserService.adoc.adoc[UserService] allows the domain object to obtain the identity of the user interacting with said object.
+The xref:system:generated:index/applib/services/user/UserService.adoc[UserService] allows the domain object to obtain the identity of the user interacting with said object.
 
-If xref:system:generated:index/applib/services/sudo/SudoService.adoc.adoc[SudoService] has been used to temporarily override the user and/or roles, then this service will report the overridden values instead.
+If xref:system:generated:index/applib/services/sudo/SudoService.adoc[SudoService] has been used to temporarily override the user and/or roles, then this service will report the overridden values instead.
 
 .Java Sources
 [source,java]
@@ -22,17 +22,17 @@ interface UserService {
 }
 ----
 
-<.> `[teal]#*currentUser*#()` : `Optional<xref:system:generated:index/applib/services/user/UserMemento.adoc.adoc[UserMemento]>`
+<.> `[teal]#*currentUser*#()` : `Optional<xref:system:generated:index/applib/services/user/UserMemento.adoc[UserMemento]>`
 +
 --
-Optionally gets the details about the current user, based on whether an xref:system:generated:index/applib/services/iactn/ExecutionContext.adoc.adoc[ExecutionContext] can be found with the current thread's context.
+Optionally gets the details about the current user, based on whether an xref:system:generated:index/applib/services/iactn/ExecutionContext.adoc[ExecutionContext] can be found with the current thread's context.
 --
-<.> `[teal]#*getUser*#()` : `xref:system:generated:index/applib/services/user/UserMemento.adoc.adoc[UserMemento]`
+<.> `[teal]#*getUser*#()` : `xref:system:generated:index/applib/services/user/UserMemento.adoc[UserMemento]`
 +
 --
 Gets the details about the current user.
 --
-<.> `[teal]#*currentUserElseFail*#()` : `xref:system:generated:index/applib/services/user/UserMemento.adoc.adoc[UserMemento]`
+<.> `[teal]#*currentUserElseFail*#()` : `xref:system:generated:index/applib/services/user/UserMemento.adoc[UserMemento]`
 +
 --
 Gets the details about the current user.
@@ -40,7 +40,7 @@ Gets the details about the current user.
 <.> `[teal]#*currentUserName*#()` : `Optional<String>`
 +
 --
-Optionally gets the the current user's name, based on whether an xref:system:generated:index/applib/services/iactn/ExecutionContext.adoc.adoc[ExecutionContext] can be found with the current thread's context.
+Optionally gets the the current user's name, based on whether an xref:system:generated:index/applib/services/iactn/ExecutionContext.adoc[ExecutionContext] can be found with the current thread's context.
 --
 <.> `[teal]#*currentUserNameElseNobody*#()` : `String`
 +
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/userreg/UserRegistrationService.adoc b/antora/components/system/modules/generated/pages/index/applib/services/userreg/UserRegistrationService.adoc
index 5e56cd3..0ca86ab 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/userreg/UserRegistrationService.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/userreg/UserRegistrationService.adoc
@@ -3,7 +3,7 @@
 
 Required API to enable users to register an account on the system (aka "sign up").
 
-User registration also requires that the xref:system:generated:index/applib/services/userreg/EmailNotificationService.adoc.adoc[EmailNotificationService] and _org.apache.isis.applib.services.email.EmailService_ to be configured. The framework provides default implementations of both of these services. The notification service requires no further configuration. The email service (EmailServiceDefault) _does_ require a couple of configuration properties to be set (specifying the SMTP mail s [...]
+User registration also requires that the xref:system:generated:index/applib/services/userreg/EmailNotificationService.adoc[EmailNotificationService] and _org.apache.isis.applib.services.email.EmailService_ to be configured. The framework provides default implementations of both of these services. The notification service requires no further configuration. The email service (EmailServiceDefault) _does_ require a couple of configuration properties to be set (specifying the SMTP mail server [...]
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/WrapperFactory.adoc b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/WrapperFactory.adoc
index 5fe0c60..bf7e1da 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/WrapperFactory.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/WrapperFactory.adoc
@@ -11,7 +11,7 @@ The 'wrap' is a runtime-code-generated proxy that wraps the underlying domain ob
 * a `set` method for properties
 * any action
 
-Calling any of the above methods may result in a (subclass of) _InteractionException_ if the object disallows it. For example, if a property is annotated as hidden then a xref:system:generated:index/applib/services/wrapper/HiddenException.adoc.adoc[HiddenException] will be thrown. Similarly if an action has a `validate` method and the supplied arguments are invalid then a xref:system:generated:index/applib/services/wrapper/InvalidException.adoc.adoc[InvalidException] will be thrown.
+Calling any of the above methods may result in a (subclass of) _InteractionException_ if the object disallows it. For example, if a property is annotated as hidden then a xref:system:generated:index/applib/services/wrapper/HiddenException.adoc[HiddenException] will be thrown. Similarly if an action has a `validate` method and the supplied arguments are invalid then a xref:system:generated:index/applib/services/wrapper/InvalidException.adoc[InvalidException] will be thrown.
 
 In addition, the following methods may also be called:
 
@@ -51,12 +51,12 @@ interface WrapperFactory {
 }
 ----
 
-<.> `[teal]#*wrap*#<T>(T domainObject, xref:system:generated:index/applib/services/wrapper/control/SyncControl.adoc.adoc[SyncControl] syncControl)` : `T`
+<.> `[teal]#*wrap*#<T>(T domainObject, xref:system:generated:index/applib/services/wrapper/control/SyncControl.adoc[SyncControl] syncControl)` : `T`
 +
 --
 Provides the "wrapper" of a domain object against which to invoke the action.
 
-The provided xref:system:generated:index/applib/services/wrapper/control/SyncControl.adoc.adoc[SyncControl] determines whether business rules are checked first, and conversely whether the action is executed. There are therefore three typical cases:
+The provided xref:system:generated:index/applib/services/wrapper/control/SyncControl.adoc[SyncControl] determines whether business rules are checked first, and conversely whether the action is executed. There are therefore three typical cases:
 
 * check rules, execute action
 * skip rules, execute action
@@ -71,12 +71,12 @@ Otherwise, will do all the validations (raise exceptions as required etc.), but
 --
 A convenience overload for _#wrap(Object, SyncControl)_ , returning a wrapper to invoke the action synchronously, enforcing business rules. Any exceptions will be propagated, not swallowed.
 --
-<.> `[teal]#*wrapMixin*#<T>(Class<T> mixinClass, Object mixedIn, xref:system:generated:index/applib/services/wrapper/control/SyncControl.adoc.adoc[SyncControl] syncControl)` : `T`
+<.> `[teal]#*wrapMixin*#<T>(Class<T> mixinClass, Object mixedIn, xref:system:generated:index/applib/services/wrapper/control/SyncControl.adoc[SyncControl] syncControl)` : `T`
 +
 --
 Provides the wrapper for a _FactoryService#mixin(Class, Object) mixin_ , against which to invoke the action.
 
-The provided xref:system:generated:index/applib/services/wrapper/control/SyncControl.adoc.adoc[SyncControl] determines whether business rules are checked first, and conversely whether the action is executed. See _#wrap(Object, SyncControl)_ for more details on this.
+The provided xref:system:generated:index/applib/services/wrapper/control/SyncControl.adoc[SyncControl] determines whether business rules are checked first, and conversely whether the action is executed. See _#wrap(Object, SyncControl)_ for more details on this.
 --
 <.> `[teal]#*wrapMixin*#<T>(Class<T> mixinClass, Object mixedIn)` : `T`
 +
@@ -95,32 +95,32 @@ If the object _#isWrapper(Object) is not wrapped_ , then should just return the
 --
 Whether the supplied object is a wrapper around a domain object.
 --
-<.> `[teal]#*asyncWrap*#<T, R>(T domainObject, xref:system:generated:index/applib/services/wrapper/control/AsyncControl.adoc.adoc[AsyncControl]<R> asyncControl)` : `T`
+<.> `[teal]#*asyncWrap*#<T, R>(T domainObject, xref:system:generated:index/applib/services/wrapper/control/AsyncControl.adoc[AsyncControl]<R> asyncControl)` : `T`
 +
 --
 Returns a proxy object for the provided _domainObject_ , through which can execute the action asynchronously.
 --
-<.> `[teal]#*asyncWrapMixin*#<T, R>(Class<T> mixinClass, Object mixedIn, xref:system:generated:index/applib/services/wrapper/control/AsyncControl.adoc.adoc[AsyncControl]<R> asyncControl)` : `T`
+<.> `[teal]#*asyncWrapMixin*#<T, R>(Class<T> mixinClass, Object mixedIn, xref:system:generated:index/applib/services/wrapper/control/AsyncControl.adoc[AsyncControl]<R> asyncControl)` : `T`
 +
 --
 Returns a proxy object for the provided _mixinClass_ , through which can execute the action asynchronously.
 --
-<.> `[teal]#*getListeners*#()` : `List<xref:system:generated:index/applib/services/wrapper/listeners/InteractionListener.adoc.adoc[InteractionListener]>`
+<.> `[teal]#*getListeners*#()` : `List<xref:system:generated:index/applib/services/wrapper/listeners/InteractionListener.adoc[InteractionListener]>`
 +
 --
-All xref:system:generated:index/applib/services/wrapper/listeners/InteractionListener.adoc.adoc[InteractionListener] s that have been registered using _#addInteractionListener(InteractionListener)_ .
+All xref:system:generated:index/applib/services/wrapper/listeners/InteractionListener.adoc[InteractionListener] s that have been registered using _#addInteractionListener(InteractionListener)_ .
 --
-<.> `[teal]#*addInteractionListener*#(xref:system:generated:index/applib/services/wrapper/listeners/InteractionListener.adoc.adoc[InteractionListener] listener)` : `boolean`
+<.> `[teal]#*addInteractionListener*#(xref:system:generated:index/applib/services/wrapper/listeners/InteractionListener.adoc[InteractionListener] listener)` : `boolean`
 +
 --
-Registers an xref:system:generated:index/applib/services/wrapper/listeners/InteractionListener.adoc.adoc[InteractionListener] , to be notified of interactions on all wrappers.
+Registers an xref:system:generated:index/applib/services/wrapper/listeners/InteractionListener.adoc[InteractionListener] , to be notified of interactions on all wrappers.
 
 This is retrospective: the listener will be notified of interactions even on wrappers created before the listener was installed. (From an implementation perspective this is because the wrappers delegate back to the container to fire the events).
 --
-<.> `[teal]#*removeInteractionListener*#(xref:system:generated:index/applib/services/wrapper/listeners/InteractionListener.adoc.adoc[InteractionListener] listener)` : `boolean`
+<.> `[teal]#*removeInteractionListener*#(xref:system:generated:index/applib/services/wrapper/listeners/InteractionListener.adoc[InteractionListener] listener)` : `boolean`
 +
 --
-Remove an xref:system:generated:index/applib/services/wrapper/listeners/InteractionListener.adoc.adoc[InteractionListener] , to no longer be notified of interactions on wrappers.
+Remove an xref:system:generated:index/applib/services/wrapper/listeners/InteractionListener.adoc[InteractionListener] , to no longer be notified of interactions on wrappers.
 
 This is retrospective: the listener will no longer be notified of any interactions created on any wrappers, not just on those wrappers created subsequently. (From an implementation perspective this is because the wrappers delegate back to the container to fire the events).
 --
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/WrappingObject.adoc b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/WrappingObject.adoc
index 1e57763..a719fc8 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/WrappingObject.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/WrappingObject.adoc
@@ -34,10 +34,10 @@ NOTE: domain classes may not have a method with this name. The `__isis_` prefix
 
  *NOTE: there is a string-literal reference to this name `DomainObjectInvocationHandler` , so it should not be changed.* .
 --
-<.> `[teal]#*__isis_executionModes*#()` : `ImmutableEnumSet<xref:system:generated:index/applib/services/wrapper/control/ExecutionMode.adoc.adoc[ExecutionMode]>`
+<.> `[teal]#*__isis_executionModes*#()` : `ImmutableEnumSet<xref:system:generated:index/applib/services/wrapper/control/ExecutionMode.adoc[ExecutionMode]>`
 +
 --
-The _EnumSetexecution modes_ inferred from the xref:system:generated:index/applib/services/wrapper/control/SyncControl.adoc.adoc[SyncControl] with which this wrapper was _WrapperFactory#wrap(Object, SyncControl) created_ .
+The _EnumSetexecution modes_ inferred from the xref:system:generated:index/applib/services/wrapper/control/SyncControl.adoc[SyncControl] with which this wrapper was _WrapperFactory#wrap(Object, SyncControl) created_ .
 
 NOTE: domain classes may not have a method with this name. The `__isis_` prefix is intended to reduce the risk of a collision.
 --
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/control/ControlAbstract.adoc b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/control/ControlAbstract.adoc
index 4bcbbcb..1d49422 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/control/ControlAbstract.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/control/ControlAbstract.adoc
@@ -18,7 +18,7 @@ class ControlAbstract {
 }
 ----
 
-<.> `[teal]#*getExecutionModes*#()` : `ImmutableEnumSet<xref:system:generated:index/applib/services/wrapper/control/ExecutionMode.adoc.adoc[ExecutionMode]>`
+<.> `[teal]#*getExecutionModes*#()` : `ImmutableEnumSet<xref:system:generated:index/applib/services/wrapper/control/ExecutionMode.adoc[ExecutionMode]>`
 +
 --
 Not API.
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/control/SyncControl.adoc b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/control/SyncControl.adoc
index 20c9eb4..5201c81 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/control/SyncControl.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/control/SyncControl.adoc
@@ -16,7 +16,7 @@ class SyncControl {
 }
 ----
 
-<.> `[teal]#*getExecutionModes*#()` : `ImmutableEnumSet<xref:system:generated:index/applib/services/wrapper/control/ExecutionMode.adoc.adoc[ExecutionMode]>`
+<.> `[teal]#*getExecutionModes*#()` : `ImmutableEnumSet<xref:system:generated:index/applib/services/wrapper/control/ExecutionMode.adoc[ExecutionMode]>`
 +
 --
 Not API.
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/ActionArgumentEvent.adoc b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/ActionArgumentEvent.adoc
index 67604df..3a4d146 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/ActionArgumentEvent.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/ActionArgumentEvent.adoc
@@ -5,7 +5,7 @@
 
 If _#getReason()_ is not `null` then provides the reason why the argument is invalid; otherwise the argument is valid.
 
-Called once per argument, and before xref:system:generated:index/applib/services/wrapper/events/ActionInvocationEvent.adoc.adoc[ActionInvocationEvent] .
+Called once per argument, and before xref:system:generated:index/applib/services/wrapper/events/ActionInvocationEvent.adoc[ActionInvocationEvent] .
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/ActionInvocationEvent.adoc b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/ActionInvocationEvent.adoc
index efe211f..618b488 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/ActionInvocationEvent.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/ActionInvocationEvent.adoc
@@ -1,11 +1,11 @@
 = ActionInvocationEvent : _class_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
- _Supported only by xref:system:generated:index/applib/services/wrapper/WrapperFactory.adoc.adoc[WrapperFactory] service,_ represents a check as to whether a particular argument for an action is valid or not.
+ _Supported only by xref:system:generated:index/applib/services/wrapper/WrapperFactory.adoc[WrapperFactory] service,_ represents a check as to whether a particular argument for an action is valid or not.
 
 If _#getReason()_ is not `null` then provides the reason why the set of arguments are invalid; otherwise the arguments are valid.
 
-Called after each of the xref:system:generated:index/applib/services/wrapper/events/ActionArgumentEvent.adoc.adoc[ActionArgumentEvent] s.
+Called after each of the xref:system:generated:index/applib/services/wrapper/events/ActionArgumentEvent.adoc[ActionArgumentEvent] s.
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/ActionVisibilityEvent.adoc b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/ActionVisibilityEvent.adoc
index 6424dc7..d7db002 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/ActionVisibilityEvent.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/ActionVisibilityEvent.adoc
@@ -1,7 +1,7 @@
 = ActionVisibilityEvent : _class_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
- _Supported only by xref:system:generated:index/applib/services/wrapper/WrapperFactory.adoc.adoc[WrapperFactory] service,_ represents a check as to whether an action is visible or has been hidden.
+ _Supported only by xref:system:generated:index/applib/services/wrapper/WrapperFactory.adoc[WrapperFactory] service,_ represents a check as to whether an action is visible or has been hidden.
 
 If _#getReason()_ is not `null` then provides the reason why the action is invisible; otherwise action is visible.
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/CollectionAccessEvent.adoc b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/CollectionAccessEvent.adoc
index 7e38b15..7069efa 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/CollectionAccessEvent.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/CollectionAccessEvent.adoc
@@ -3,7 +3,7 @@
 
  _Supported only by _org.apache.isis.applib.services.wrapper.WrapperFactory_ service,_ represents an access (reading) of a collection.
 
-Analogous to xref:system:generated:index/applib/services/wrapper/events/CollectionAddToEvent.adoc.adoc[CollectionAddToEvent] or xref:system:generated:index/applib/services/wrapper/events/CollectionRemoveFromEvent.adoc.adoc[CollectionRemoveFromEvent] , however the _#getReason()_ will always be `null` . (If access is not allowed then a vetoing _CollectionVisibilityEvent_ would have been fired).
+Analogous to xref:system:generated:index/applib/services/wrapper/events/CollectionAddToEvent.adoc[CollectionAddToEvent] or xref:system:generated:index/applib/services/wrapper/events/CollectionRemoveFromEvent.adoc[CollectionRemoveFromEvent] , however the _#getReason()_ will always be `null` . (If access is not allowed then a vetoing _CollectionVisibilityEvent_ would have been fired).
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/InteractionEvent.adoc b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/InteractionEvent.adoc
index fd208ed..4207e9b 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/InteractionEvent.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/InteractionEvent.adoc
@@ -45,12 +45,12 @@ class InteractionEvent {
 --
 The domain object (pojo) against which the interaction occurred.
 --
-<.> `[teal]#*getIdentifier*#()` : `xref:system:generated:index/applib/Identifier.adoc.adoc[Identifier]`
+<.> `[teal]#*getIdentifier*#()` : `xref:system:generated:index/applib/Identifier.adoc[Identifier]`
 +
 --
-The xref:system:generated:index/applib/Identifier.adoc.adoc[Identifier] of the feature of the object being interacted with.
+The xref:system:generated:index/applib/Identifier.adoc[Identifier] of the feature of the object being interacted with.
 
-Will be consistent with the subclass of xref:system:generated:index/applib/services/wrapper/events/InteractionEvent.adoc.adoc[InteractionEvent] . So for example a xref:system:generated:index/applib/services/wrapper/events/PropertyModifyEvent.adoc.adoc[PropertyModifyEvent] will have an xref:system:generated:index/applib/Identifier.adoc.adoc[Identifier] that identifies the property being modified.
+Will be consistent with the subclass of xref:system:generated:index/applib/services/wrapper/events/InteractionEvent.adoc[InteractionEvent] . So for example a xref:system:generated:index/applib/services/wrapper/events/PropertyModifyEvent.adoc[PropertyModifyEvent] will have an xref:system:generated:index/applib/Identifier.adoc[Identifier] that identifies the property being modified.
 --
 <.> `[teal]#*getClassName*#()` : `String`
 +
@@ -113,8 +113,8 @@ Whether this interaction has been vetoed (meaning that _#getReason()_ and _#getA
 
 The interpretation of this depends on the subclass:
 
-* for xref:system:generated:index/applib/services/wrapper/events/VisibilityEvent.adoc.adoc[VisibilityEvent] , a veto means that the feature (property, collection, action) is hidden
-* for xref:system:generated:index/applib/services/wrapper/events/UsabilityEvent.adoc.adoc[UsabilityEvent] , a veto means that the feature is disabled
-* for xref:system:generated:index/applib/services/wrapper/events/ValidityEvent.adoc.adoc[ValidityEvent] , a veto means that the proposed modification (property value, object added/removed, action argument) is invalid
+* for xref:system:generated:index/applib/services/wrapper/events/VisibilityEvent.adoc[VisibilityEvent] , a veto means that the feature (property, collection, action) is hidden
+* for xref:system:generated:index/applib/services/wrapper/events/UsabilityEvent.adoc[UsabilityEvent] , a veto means that the feature is disabled
+* for xref:system:generated:index/applib/services/wrapper/events/ValidityEvent.adoc[ValidityEvent] , a veto means that the proposed modification (property value, object added/removed, action argument) is invalid
 --
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/PropertyAccessEvent.adoc b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/PropertyAccessEvent.adoc
index c175489..7dd07d3 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/PropertyAccessEvent.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/PropertyAccessEvent.adoc
@@ -3,7 +3,7 @@
 
  _Supported only by _org.apache.isis.applib.services.wrapper.WrapperFactory_ service,_ represents an access (reading) of a property.
 
-Analogous to xref:system:generated:index/applib/services/wrapper/events/PropertyModifyEvent.adoc.adoc[PropertyModifyEvent] , however the _#getReason()_ will always be `null` . (If access is not allowed then a xref:system:generated:index/applib/services/wrapper/events/PropertyVisibilityEvent.adoc.adoc[PropertyVisibilityEvent] would have been fired).
+Analogous to xref:system:generated:index/applib/services/wrapper/events/PropertyModifyEvent.adoc[PropertyModifyEvent] , however the _#getReason()_ will always be `null` . (If access is not allowed then a xref:system:generated:index/applib/services/wrapper/events/PropertyVisibilityEvent.adoc[PropertyVisibilityEvent] would have been fired).
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/ProposedHolderEvent.adoc b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/ProposedHolderEvent.adoc
index ad6c8da..1eeb50d 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/ProposedHolderEvent.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/ProposedHolderEvent.adoc
@@ -1,7 +1,7 @@
 = ProposedHolderEvent : _interface_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
- _Supported only by _org.apache.isis.applib.services.wrapper.WrapperFactory_ service,_ makes it easier to process different events that hold a single proposed argument (such as xref:system:generated:index/applib/services/wrapper/events/CollectionAddToEvent.adoc.adoc[CollectionAddToEvent] and xref:system:generated:index/applib/services/wrapper/events/PropertyModifyEvent.adoc.adoc[PropertyModifyEvent] ).
+ _Supported only by _org.apache.isis.applib.services.wrapper.WrapperFactory_ service,_ makes it easier to process different events that hold a single proposed argument (such as xref:system:generated:index/applib/services/wrapper/events/CollectionAddToEvent.adoc[CollectionAddToEvent] and xref:system:generated:index/applib/services/wrapper/events/PropertyModifyEvent.adoc[PropertyModifyEvent] ).
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/VisibilityEvent.adoc b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/VisibilityEvent.adoc
index b715756..b89c99d 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/VisibilityEvent.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/events/VisibilityEvent.adoc
@@ -1,7 +1,7 @@
 = VisibilityEvent : _class_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
- _Supported only by xref:system:generated:index/applib/services/wrapper/WrapperFactory.adoc.adoc[WrapperFactory] service,_ represents a check to determine whether a member of an object is visible or has been hidden.
+ _Supported only by xref:system:generated:index/applib/services/wrapper/WrapperFactory.adoc[WrapperFactory] service,_ represents a check to determine whether a member of an object is visible or has been hidden.
 
 If _#getReason()_ is `null` , then is usable; otherwise is invisible.
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/listeners/InteractionAdapter.adoc b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/listeners/InteractionAdapter.adoc
index 56eec40..0f44e84 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/listeners/InteractionAdapter.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/listeners/InteractionAdapter.adoc
@@ -1,7 +1,7 @@
 = InteractionAdapter : _class_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-Provides no-op implementations of each of the methods within xref:system:generated:index/applib/services/wrapper/listeners/InteractionListener.adoc.adoc[InteractionListener] , to simplify the creation of new listeners.
+Provides no-op implementations of each of the methods within xref:system:generated:index/applib/services/wrapper/listeners/InteractionListener.adoc[InteractionListener] , to simplify the creation of new listeners.
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/listeners/InteractionListener.adoc b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/listeners/InteractionListener.adoc
index db3ac71..ee0b5e7 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/wrapper/listeners/InteractionListener.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/wrapper/listeners/InteractionListener.adoc
@@ -40,34 +40,34 @@ interface InteractionListener {
 }
 ----
 
-<.> `[teal]#*objectTitleRead*#(xref:system:generated:index/applib/services/wrapper/events/ObjectTitleEvent.adoc.adoc[ObjectTitleEvent] ev)` : `void`
+<.> `[teal]#*objectTitleRead*#(xref:system:generated:index/applib/services/wrapper/events/ObjectTitleEvent.adoc[ObjectTitleEvent] ev)` : `void`
 +
 --
 The title was read.
 --
-<.> `[teal]#*objectPersisted*#(xref:system:generated:index/applib/services/wrapper/events/ObjectValidityEvent.adoc.adoc[ObjectValidityEvent] ev)` : `void`
+<.> `[teal]#*objectPersisted*#(xref:system:generated:index/applib/services/wrapper/events/ObjectValidityEvent.adoc[ObjectValidityEvent] ev)` : `void`
 +
 --
 The object was persisted (or an attempt to persist it was made).
 --
-<.> `[teal]#*propertyVisible*#(xref:system:generated:index/applib/services/wrapper/events/PropertyVisibilityEvent.adoc.adoc[PropertyVisibilityEvent] ev)` : `void`
+<.> `[teal]#*propertyVisible*#(xref:system:generated:index/applib/services/wrapper/events/PropertyVisibilityEvent.adoc[PropertyVisibilityEvent] ev)` : `void`
 +
 --
 A check was made to determine if a property was visible.
 --
-<.> `[teal]#*propertyUsable*#(xref:system:generated:index/applib/services/wrapper/events/PropertyUsabilityEvent.adoc.adoc[PropertyUsabilityEvent] ev)` : `void`
+<.> `[teal]#*propertyUsable*#(xref:system:generated:index/applib/services/wrapper/events/PropertyUsabilityEvent.adoc[PropertyUsabilityEvent] ev)` : `void`
 +
 --
 A check was made to determine if a property was usable.
 --
-<.> `[teal]#*propertyAccessed*#(xref:system:generated:index/applib/services/wrapper/events/PropertyAccessEvent.adoc.adoc[PropertyAccessEvent] ev)` : `void`
+<.> `[teal]#*propertyAccessed*#(xref:system:generated:index/applib/services/wrapper/events/PropertyAccessEvent.adoc[PropertyAccessEvent] ev)` : `void`
 +
 --
 A property was read.
 
-Unlike most other events, a xref:system:generated:index/applib/services/wrapper/events/PropertyAccessEvent.adoc.adoc[PropertyAccessEvent] will never have been vetoed (that is, _PropertyAccessEvent#isVeto()_ will always be `false` ).
+Unlike most other events, a xref:system:generated:index/applib/services/wrapper/events/PropertyAccessEvent.adoc[PropertyAccessEvent] will never have been vetoed (that is, _PropertyAccessEvent#isVeto()_ will always be `false` ).
 --
-<.> `[teal]#*propertyModified*#(xref:system:generated:index/applib/services/wrapper/events/PropertyModifyEvent.adoc.adoc[PropertyModifyEvent] ev)` : `void`
+<.> `[teal]#*propertyModified*#(xref:system:generated:index/applib/services/wrapper/events/PropertyModifyEvent.adoc[PropertyModifyEvent] ev)` : `void`
 +
 --
 A property was modified (or an attempt to modify it was made)
@@ -81,59 +81,59 @@ A check was made to determine if a collection was visible.
 
 Will be fired prior to _#collectionUsable(CollectionUsabilityEvent)_ .
 --
-<.> `[teal]#*collectionUsable*#(xref:system:generated:index/applib/services/wrapper/events/CollectionUsabilityEvent.adoc.adoc[CollectionUsabilityEvent] ev)` : `void`
+<.> `[teal]#*collectionUsable*#(xref:system:generated:index/applib/services/wrapper/events/CollectionUsabilityEvent.adoc[CollectionUsabilityEvent] ev)` : `void`
 +
 --
 A check was made to determine if a collection was usable.
 
 Will be fired prior to either _#collectionAccessed(CollectionAccessEvent)_ or _#collectionAddedTo(CollectionAddToEvent)_ or _#collectionRemovedFrom(CollectionRemoveFromEvent)_ .
 --
-<.> `[teal]#*collectionAccessed*#(xref:system:generated:index/applib/services/wrapper/events/CollectionAccessEvent.adoc.adoc[CollectionAccessEvent] ev)` : `void`
+<.> `[teal]#*collectionAccessed*#(xref:system:generated:index/applib/services/wrapper/events/CollectionAccessEvent.adoc[CollectionAccessEvent] ev)` : `void`
 +
 --
 A collection was read.
 
-Unlike most other events, a xref:system:generated:index/applib/services/wrapper/events/CollectionAccessEvent.adoc.adoc[CollectionAccessEvent] will never have been vetoed (that is, _CollectionAccessEvent#isVeto()_ will always be `false` ).
+Unlike most other events, a xref:system:generated:index/applib/services/wrapper/events/CollectionAccessEvent.adoc[CollectionAccessEvent] will never have been vetoed (that is, _CollectionAccessEvent#isVeto()_ will always be `false` ).
 --
-<.> `[teal]#*collectionAddedTo*#(xref:system:generated:index/applib/services/wrapper/events/CollectionAddToEvent.adoc.adoc[CollectionAddToEvent] ev)` : `void`
+<.> `[teal]#*collectionAddedTo*#(xref:system:generated:index/applib/services/wrapper/events/CollectionAddToEvent.adoc[CollectionAddToEvent] ev)` : `void`
 +
 --
 An object was added to the collection (or an attempt to add it was made).
 --
-<.> `[teal]#*collectionRemovedFrom*#(xref:system:generated:index/applib/services/wrapper/events/CollectionRemoveFromEvent.adoc.adoc[CollectionRemoveFromEvent] ev)` : `void`
+<.> `[teal]#*collectionRemovedFrom*#(xref:system:generated:index/applib/services/wrapper/events/CollectionRemoveFromEvent.adoc[CollectionRemoveFromEvent] ev)` : `void`
 +
 --
 An object was removed from the collection (or an attempt to remove it was made).
 --
-<.> `[teal]#*collectionMethodInvoked*#(xref:system:generated:index/applib/services/wrapper/events/CollectionMethodEvent.adoc.adoc[CollectionMethodEvent] interactionEvent)` : `void`
+<.> `[teal]#*collectionMethodInvoked*#(xref:system:generated:index/applib/services/wrapper/events/CollectionMethodEvent.adoc[CollectionMethodEvent] interactionEvent)` : `void`
 +
 --
 A method of a collection (such as `isEmpty()` or `size()` ) has been invoked.
 
 Unlike the other methods in this interface, the source of these events will be an instance of a Collection (such as `java.util.List` ) rather than the domain object. (The domain object is {@link CollectionMethodEvent#getDomainObject() still available, however).
 --
-<.> `[teal]#*actionVisible*#(xref:system:generated:index/applib/services/wrapper/events/ActionVisibilityEvent.adoc.adoc[ActionVisibilityEvent] interactionEvent)` : `void`
+<.> `[teal]#*actionVisible*#(xref:system:generated:index/applib/services/wrapper/events/ActionVisibilityEvent.adoc[ActionVisibilityEvent] interactionEvent)` : `void`
 +
 --
 A check was made to determine if an action was visible.
 
 Will be fired prior to _#actionUsable(ActionUsabilityEvent)_ .
 --
-<.> `[teal]#*actionUsable*#(xref:system:generated:index/applib/services/wrapper/events/ActionUsabilityEvent.adoc.adoc[ActionUsabilityEvent] ev)` : `void`
+<.> `[teal]#*actionUsable*#(xref:system:generated:index/applib/services/wrapper/events/ActionUsabilityEvent.adoc[ActionUsabilityEvent] ev)` : `void`
 +
 --
 A check was made to determine if an action was usable.
 
 Will be fired prior to _#actionArgument(ActionArgumentEvent)_ .
 --
-<.> `[teal]#*actionArgument*#(xref:system:generated:index/applib/services/wrapper/events/ActionArgumentEvent.adoc.adoc[ActionArgumentEvent] ev)` : `void`
+<.> `[teal]#*actionArgument*#(xref:system:generated:index/applib/services/wrapper/events/ActionArgumentEvent.adoc[ActionArgumentEvent] ev)` : `void`
 +
 --
 A check was made as to whether an argument proposed for an action was valid.
 
 Will be fired prior to _#actionInvoked(ActionInvocationEvent)_ .
 --
-<.> `[teal]#*actionInvoked*#(xref:system:generated:index/applib/services/wrapper/events/ActionInvocationEvent.adoc.adoc[ActionInvocationEvent] ev)` : `void`
+<.> `[teal]#*actionInvoked*#(xref:system:generated:index/applib/services/wrapper/events/ActionInvocationEvent.adoc[ActionInvocationEvent] ev)` : `void`
 +
 --
 An action was invoked (or an attempt to invoke it was made).
diff --git a/antora/components/system/modules/generated/pages/index/applib/services/xactn/TransactionService.adoc b/antora/components/system/modules/generated/pages/index/applib/services/xactn/TransactionService.adoc
index ffaec20..691a8b8 100644
--- a/antora/components/system/modules/generated/pages/index/applib/services/xactn/TransactionService.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/services/xactn/TransactionService.adoc
@@ -20,12 +20,12 @@ interface TransactionService {
 }
 ----
 
-<.> `[teal]#*currentTransactionId*#()` : `xref:system:generated:index/applib/services/xactn/TransactionId.adoc.adoc[TransactionId]`
+<.> `[teal]#*currentTransactionId*#()` : `xref:system:generated:index/applib/services/xactn/TransactionId.adoc[TransactionId]`
 +
 --
 When called within an existing transactional boundary returns the unique identifier to the transaction, _null_ otherwise.
 --
-<.> `[teal]#*currentTransactionState*#()` : `xref:system:generated:index/applib/services/xactn/TransactionState.adoc.adoc[TransactionState]`
+<.> `[teal]#*currentTransactionState*#()` : `xref:system:generated:index/applib/services/xactn/TransactionState.adoc[TransactionState]`
 <.> `[teal]#*flushTransaction*#()` : `void`
 +
 --
diff --git a/antora/components/system/modules/generated/pages/index/applib/snapshot/SnapshottableWithInclusions.adoc b/antora/components/system/modules/generated/pages/index/applib/snapshot/SnapshottableWithInclusions.adoc
index 975f4f0..eb3ba59 100644
--- a/antora/components/system/modules/generated/pages/index/applib/snapshot/SnapshottableWithInclusions.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/snapshot/SnapshottableWithInclusions.adoc
@@ -1,7 +1,7 @@
 = SnapshottableWithInclusions : _interface_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-Optional interface for domain objects with which an snapshot is to be created using the xref:system:generated:index/applib/services/xmlsnapshot/XmlSnapshotService.adoc.adoc[XmlSnapshotService] , indicating paths to be _XmlSnapshotService.Snapshot#_ automatically include additional paths within the snapshot.
+Optional interface for domain objects with which an snapshot is to be created using the xref:system:generated:index/applib/services/xmlsnapshot/XmlSnapshotService.adoc[XmlSnapshotService] , indicating paths to be _XmlSnapshotService.Snapshot#_ automatically include additional paths within the snapshot.
 
 .Java Sources
 [source,java]
diff --git a/antora/components/system/modules/generated/pages/index/applib/spec/AbstractSpecification.adoc b/antora/components/system/modules/generated/pages/index/applib/spec/AbstractSpecification.adoc
index b15f6e9..6f08d0d 100644
--- a/antora/components/system/modules/generated/pages/index/applib/spec/AbstractSpecification.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/spec/AbstractSpecification.adoc
@@ -1,7 +1,7 @@
 = AbstractSpecification : _class_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-Adapter to make it easy to write xref:system:generated:index/applib/spec/Specification.adoc.adoc[Specification] s.
+Adapter to make it easy to write xref:system:generated:index/applib/spec/Specification.adoc[Specification] s.
 
 Provides two main features:
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/spec/AbstractSpecification2.adoc b/antora/components/system/modules/generated/pages/index/applib/spec/AbstractSpecification2.adoc
index 03c28bf..1b86b73 100644
--- a/antora/components/system/modules/generated/pages/index/applib/spec/AbstractSpecification2.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/spec/AbstractSpecification2.adoc
@@ -1,7 +1,7 @@
 = AbstractSpecification2 : _class_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-Adapter to make it easy to write xref:system:generated:index/applib/spec/Specification.adoc.adoc[Specification] s.
+Adapter to make it easy to write xref:system:generated:index/applib/spec/Specification.adoc[Specification] s.
 
 Provides two main features:
 
@@ -21,7 +21,7 @@ class AbstractSpecification2 {
 }
 ----
 
-<.> `[teal]#*satisfiesTranslatable*#(Object obj)` : `xref:system:generated:index/applib/services/i18n/TranslatableString.adoc.adoc[TranslatableString]`
+<.> `[teal]#*satisfiesTranslatable*#(Object obj)` : `xref:system:generated:index/applib/services/i18n/TranslatableString.adoc[TranslatableString]`
 +
 --
 Checks not null and is correct type, and delegates to _#satisfiesTranslatableSafely(Object)_ .
diff --git a/antora/components/system/modules/generated/pages/index/applib/spec/Specification2.adoc b/antora/components/system/modules/generated/pages/index/applib/spec/Specification2.adoc
index c47e7c8..a821e8d 100644
--- a/antora/components/system/modules/generated/pages/index/applib/spec/Specification2.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/spec/Specification2.adoc
@@ -1,9 +1,9 @@
 = Specification2 : _interface_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-Optional extension to the base xref:system:generated:index/applib/spec/Specification.adoc.adoc[Specification] , to allow for i18n.
+Optional extension to the base xref:system:generated:index/applib/spec/Specification.adoc[Specification] , to allow for i18n.
 
-If implemented, then the _#satisfies(Object)_ inherited from xref:system:generated:index/applib/spec/Specification.adoc.adoc[Specification] can just return `null` ; it will never be called by the framework.
+If implemented, then the _#satisfies(Object)_ inherited from xref:system:generated:index/applib/spec/Specification.adoc[Specification] can just return `null` ; it will never be called by the framework.
 
 .Java Sources
 [source,java]
@@ -14,9 +14,9 @@ interface Specification2 {
 }
 ----
 
-<.> `[teal]#*satisfiesTranslatable*#(Object obj)` : `xref:system:generated:index/applib/services/i18n/TranslatableString.adoc.adoc[TranslatableString]`
+<.> `[teal]#*satisfiesTranslatable*#(Object obj)` : `xref:system:generated:index/applib/services/i18n/TranslatableString.adoc[TranslatableString]`
 +
 --
-If `null` then satisfied, otherwise is the reason (as a xref:system:generated:index/applib/services/i18n/TranslatableString.adoc.adoc[TranslatableString] translatable string) as to why the specification is not satisfied.
+If `null` then satisfied, otherwise is the reason (as a xref:system:generated:index/applib/services/i18n/TranslatableString.adoc[TranslatableString] translatable string) as to why the specification is not satisfied.
 --
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/spec/SpecificationAnd.adoc b/antora/components/system/modules/generated/pages/index/applib/spec/SpecificationAnd.adoc
index fa01f15..2a54a88 100644
--- a/antora/components/system/modules/generated/pages/index/applib/spec/SpecificationAnd.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/spec/SpecificationAnd.adoc
@@ -1,9 +1,9 @@
 = SpecificationAnd : _class_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-Adapter to make it easy to perform boolean algebra on xref:system:generated:index/applib/spec/Specification.adoc.adoc[Specification] s.
+Adapter to make it easy to perform boolean algebra on xref:system:generated:index/applib/spec/Specification.adoc[Specification] s.
 
-Subclasses represent the intersection of multiple xref:system:generated:index/applib/spec/Specification.adoc.adoc[Specification] s. An implementation should instantiate the xref:system:generated:index/applib/spec/Specification.adoc.adoc[Specification] s to be satisfied in its constructor.
+Subclasses represent the intersection of multiple xref:system:generated:index/applib/spec/Specification.adoc[Specification] s. An implementation should instantiate the xref:system:generated:index/applib/spec/Specification.adoc[Specification] s to be satisfied in its constructor.
 
 For example:
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/spec/SpecificationNot.adoc b/antora/components/system/modules/generated/pages/index/applib/spec/SpecificationNot.adoc
index ac3f3a6..068f6ebc 100644
--- a/antora/components/system/modules/generated/pages/index/applib/spec/SpecificationNot.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/spec/SpecificationNot.adoc
@@ -1,9 +1,9 @@
 = SpecificationNot : _class_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-Adapter to make it easy to perform boolean algebra on xref:system:generated:index/applib/spec/Specification.adoc.adoc[Specification] s.
+Adapter to make it easy to perform boolean algebra on xref:system:generated:index/applib/spec/Specification.adoc[Specification] s.
 
-Subclasses represent the logical inverse of a xref:system:generated:index/applib/spec/Specification.adoc.adoc[Specification] s. An implementation should instantiate the xref:system:generated:index/applib/spec/Specification.adoc.adoc[Specification] s to be satisfied in its constructor.
+Subclasses represent the logical inverse of a xref:system:generated:index/applib/spec/Specification.adoc[Specification] s. An implementation should instantiate the xref:system:generated:index/applib/spec/Specification.adoc[Specification] s to be satisfied in its constructor.
 
 For example:
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/spec/SpecificationOr.adoc b/antora/components/system/modules/generated/pages/index/applib/spec/SpecificationOr.adoc
index 77dd497..2216f03 100644
--- a/antora/components/system/modules/generated/pages/index/applib/spec/SpecificationOr.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/spec/SpecificationOr.adoc
@@ -1,9 +1,9 @@
 = SpecificationOr : _class_
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-Adapter to make it easy to perform boolean algebra on xref:system:generated:index/applib/spec/Specification.adoc.adoc[Specification] s.
+Adapter to make it easy to perform boolean algebra on xref:system:generated:index/applib/spec/Specification.adoc[Specification] s.
 
-Subclasses represent the conjunction of multiple xref:system:generated:index/applib/spec/Specification.adoc.adoc[Specification] s. An implementation should instantiate the xref:system:generated:index/applib/spec/Specification.adoc.adoc[Specification] s to be satisfied in its constructor.
+Subclasses represent the conjunction of multiple xref:system:generated:index/applib/spec/Specification.adoc[Specification] s. An implementation should instantiate the xref:system:generated:index/applib/spec/Specification.adoc[Specification] s to be satisfied in its constructor.
 
 For example:
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/value/Blob.adoc b/antora/components/system/modules/generated/pages/index/applib/value/Blob.adoc
index e0e570b..80b909b 100644
--- a/antora/components/system/modules/generated/pages/index/applib/value/Blob.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/value/Blob.adoc
@@ -32,14 +32,14 @@ class Blob {
 }
 ----
 
-<.> `[teal]#*_of_*#(String name, CommonMimeType mimeType, byte[] content)` : `xref:system:generated:index/applib/value/Blob.adoc.adoc[Blob]`
+<.> `[teal]#*_of_*#(String name, CommonMimeType mimeType, byte[] content)` : `xref:system:generated:index/applib/value/Blob.adoc[Blob]`
 +
 --
-Returns a new xref:system:generated:index/applib/value/Blob.adoc.adoc[Blob] of given _name_ , _mimeType_ and _content_ .
+Returns a new xref:system:generated:index/applib/value/Blob.adoc[Blob] of given _name_ , _mimeType_ and _content_ .
 
-_name_ may or may not include the desired filename extension, it is guaranteed, that the resulting xref:system:generated:index/applib/value/Blob.adoc.adoc[Blob] has the appropriate extension as constraint by the given _mimeType_ .
+_name_ may or may not include the desired filename extension, it is guaranteed, that the resulting xref:system:generated:index/applib/value/Blob.adoc[Blob] has the appropriate extension as constraint by the given _mimeType_ .
 
-For more fine-grained control use one of the xref:system:generated:index/applib/value/Blob.adoc.adoc[Blob] constructors directly.
+For more fine-grained control use one of the xref:system:generated:index/applib/value/Blob.adoc[Blob] constructors directly.
 --
 <.> `[teal]#*writeBytesTo*#(OutputStream os)` : `void`
 +
diff --git a/antora/components/system/modules/generated/pages/index/applib/value/Clob.adoc b/antora/components/system/modules/generated/pages/index/applib/value/Clob.adoc
index d205e6f..cc52ddc 100644
--- a/antora/components/system/modules/generated/pages/index/applib/value/Clob.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/value/Clob.adoc
@@ -36,13 +36,13 @@ class Clob {
 }
 ----
 
-<.> `[teal]#*_of_*#(String name, CommonMimeType mimeType, CharSequence content)` : `xref:system:generated:index/applib/value/Clob.adoc.adoc[Clob]`
+<.> `[teal]#*_of_*#(String name, CommonMimeType mimeType, CharSequence content)` : `xref:system:generated:index/applib/value/Clob.adoc[Clob]`
 +
 --
-Returns a new xref:system:generated:index/applib/value/Clob.adoc.adoc[Clob] of given _name_ , _mimeType_ and _content_ .
+Returns a new xref:system:generated:index/applib/value/Clob.adoc[Clob] of given _name_ , _mimeType_ and _content_ .
 
-_name_ may or may not include the desired filename extension, it is guaranteed, that the resulting xref:system:generated:index/applib/value/Clob.adoc.adoc[Clob] has the appropriate extension as constraint by the given _mimeType_ .
+_name_ may or may not include the desired filename extension, it is guaranteed, that the resulting xref:system:generated:index/applib/value/Clob.adoc[Clob] has the appropriate extension as constraint by the given _mimeType_ .
 
-For more fine-grained control use one of the xref:system:generated:index/applib/value/Clob.adoc.adoc[Clob] constructors directly.
+For more fine-grained control use one of the xref:system:generated:index/applib/value/Clob.adoc[Clob] constructors directly.
 --
 
diff --git a/antora/components/system/modules/generated/pages/index/applib/value/Markup.adoc b/antora/components/system/modules/generated/pages/index/applib/value/Markup.adoc
index a07c55b..bfc7391 100644
--- a/antora/components/system/modules/generated/pages/index/applib/value/Markup.adoc
+++ b/antora/components/system/modules/generated/pages/index/applib/value/Markup.adoc
@@ -28,7 +28,7 @@ class Markup {
 }
 ----
 
-<.> `[teal]#*_valueOfHtml_*#(String html)` : `xref:system:generated:index/applib/value/Markup.adoc.adoc[Markup]`
+<.> `[teal]#*_valueOfHtml_*#(String html)` : `xref:system:generated:index/applib/value/Markup.adoc[Markup]`
 +
 --
 syntactic sugar
diff --git a/antora/components/system/modules/generated/pages/system-overview.adoc b/antora/components/system/modules/generated/pages/system-overview.adoc
index 5698792..74357a8 100644
--- a/antora/components/system/modules/generated/pages/system-overview.adoc
+++ b/antora/components/system/modules/generated/pages/system-overview.adoc
@@ -160,7 +160,7 @@ _Dependencies_
 
 _Document Index Entries_
 
-xref:system:generated:index/commons/having/HasUniqueId.adoc.adoc[HasUniqueId], xref:system:generated:index/commons/having/HasUsername.adoc.adoc[HasUsername]
+xref:system:generated:index/commons/having/HasUniqueId.adoc[HasUniqueId], xref:system:generated:index/commons/having/HasUsername.adoc[HasUsername]
 |===
 
 == Core
@@ -322,7 +322,7 @@ _Dependencies_
 
 _Document Index Entries_
 
-xref:system:generated:index/applib/AbstractViewModel.adoc.adoc[AbstractViewModel], xref:system:generated:index/applib/ApplicationException.adoc.adoc[ApplicationException], xref:system:generated:index/applib/FatalException.adoc.adoc[FatalException], xref:system:generated:index/applib/Identifier.adoc.adoc[Identifier], xref:system:generated:index/applib/NonRecoverableException.adoc.adoc[NonRecoverableException], xref:system:generated:index/applib/PersistFailedException.adoc.adoc[PersistFail [...]
+xref:system:generated:index/applib/AbstractViewModel.adoc[AbstractViewModel], xref:system:generated:index/applib/ApplicationException.adoc[ApplicationException], xref:system:generated:index/applib/FatalException.adoc[FatalException], xref:system:generated:index/applib/Identifier.adoc[Identifier], xref:system:generated:index/applib/NonRecoverableException.adoc[NonRecoverableException], xref:system:generated:index/applib/PersistFailedException.adoc[PersistFailedException], xref:system:gene [...]
 
 |Apache Isis Core - Code Gen (ByteBuddy)
 [source,yaml]
@@ -471,7 +471,7 @@ _Dependencies_
 
 _Document Index Entries_
 
-xref:system:generated:index/core/runtime/persistence/changetracking/EntityChangeTrackerDefault.adoc.adoc[EntityChangeTrackerDefault]
+xref:system:generated:index/core/runtime/persistence/changetracking/EntityChangeTrackerDefault.adoc[EntityChangeTrackerDefault]
 
 |Apache Isis Core - Runtime Services
 [source,yaml]
@@ -529,7 +529,7 @@ _Dependencies_
 
 _Document Index Entries_
 
-xref:system:generated:index/core/runtimeservices/xml/XmlServiceDefault.adoc.adoc[XmlServiceDefault], xref:system:generated:index/core/runtimeservices/xmlsnapshot/XmlSnapshotServiceDefault.adoc.adoc[XmlSnapshotServiceDefault]
+xref:system:generated:index/core/runtimeservices/xml/XmlServiceDefault.adoc[XmlServiceDefault], xref:system:generated:index/core/runtimeservices/xmlsnapshot/XmlSnapshotServiceDefault.adoc[XmlSnapshotServiceDefault]
 
 |Apache Isis Core - Security
 [source,yaml]