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

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


The following commit(s) were added to refs/heads/3.0.0 by this push:
     new 19619ff6bc CAUSEWAY-3666: updates docs
19619ff6bc is described below

commit 19619ff6bc7fe83fed90250e75903a09af6b233d
Author: danhaywood <[email protected]>
AuthorDate: Mon Mar 25 23:24:35 2024 +0000

    CAUSEWAY-3666: updates docs
---
 .../pages/index/annotation/PriorityPrecedence.adoc |   4 +-
 .../modules/applib/pages/index/mixins/dto/Dto.adoc |   2 +-
 .../mixins/metamodel/Object_logicalTypeName.adoc   |   2 +-
 .../mixins/metamodel/Object_objectIdentifier.adoc  |   2 +-
 .../index/services/inject/ServiceInjector.adoc     |   2 +-
 .../keyvaluestore/KeyValueSessionStore.adoc        |   2 +-
 .../pages/index/functional/ThrowingConsumer.adoc   | 100 ---------------------
 .../pages/index/functional/ThrowingSupplier.adoc   | 100 ---------------------
 .../modules/commons/pages/index/io/JsonUtils.adoc  |  11 +++
 .../modules/commons/pages/index/io/YamlUtils.adoc  |  44 +++++++++
 .../pages/index/jdo/applib/types/Money.adoc        |   4 +-
 .../pages/index/jdo/applib/types/Percentage.adoc   |   4 +-
 .../applib/integration/CausewayEntityListener.adoc |   2 +-
 .../index/jpa/applib/types/BlobJpaEmbeddable.adoc  |   2 +-
 .../index/jpa/applib/types/ClobJpaEmbeddable.adoc  |   2 +-
 .../keycloak/CausewayModuleSecurityKeycloak.adoc   |   2 +-
 .../index/shiro/webmodule/WebModuleShiro.adoc      |   1 -
 .../authconverters/AuthenticationConverter.adoc    |   2 +-
 .../applib/classrules/ArchitectureDomainRules.adoc |   8 +-
 .../applib/classrules/ArchitectureJdoRules.adoc    |   4 +-
 .../applib/classrules/ArchitectureJpaRules.adoc    |  16 ++--
 .../applib/matchers/JaxbMatchers.adoc              |   4 +-
 .../applib/services/menu/MenuUiService.adoc        |   3 +-
 .../applib/marshallers/ScalarMarshaller.adoc       |   2 +-
 .../ContentNegotiationServiceXRoDomainType.adoc    |   2 +-
 core/adoc/modules/_overview/pages/about.adoc       |  97 +++++++++++---------
 26 files changed, 145 insertions(+), 279 deletions(-)

diff --git 
a/antora/components/refguide-index/modules/applib/pages/index/annotation/PriorityPrecedence.adoc
 
b/antora/components/refguide-index/modules/applib/pages/index/annotation/PriorityPrecedence.adoc
index 43ae0ac1ab..7e267c988f 100644
--- 
a/antora/components/refguide-index/modules/applib/pages/index/annotation/PriorityPrecedence.adoc
+++ 
b/antora/components/refguide-index/modules/applib/pages/index/annotation/PriorityPrecedence.adoc
@@ -1,7 +1,7 @@
 = PriorityPrecedence
 :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 [...]
 
-Constants for use with _javax.annotation.Priority_ , used both to determine 
which service to inject into a scalar field when there are multiple candidates, 
and also to order services if injecting into a vector field (in other words, 
into a _java.util.List_ ).
+Constants for use with _jakarta.annotation.Priority_ , used both to determine 
which service to inject into a scalar field when there are multiple candidates, 
and also to order services if injecting into a vector field (in other words, 
into a _java.util.List_ ).
 
 == API
 
@@ -52,7 +52,7 @@ For domain services with the highest precedence (priority) 
value.
 
 No framework services use this constant, but some very fundamental services 
(eg for security) that are not expected to be overridden use a value that is 
only a little after this first value.
 
-Note that this is a non-negative value, because _javax.annotation.Priority_ 's 
javadoc states: "priority values should generally be non-negative, with 
negative values * reserved for special meanings such as _undefined_ or _not 
specified_ .". In particular, it is _not_ the same as 
_Ordered#HIGHEST_PRECEDENCE_ .
+Note that this is a non-negative value, because _jakarta.annotation.Priority_ 
's javadoc states: "priority values should generally be non-negative, with 
negative values * reserved for special meanings such as _undefined_ or _not 
specified_ .". In particular, it is _not_ the same as 
_Ordered#HIGHEST_PRECEDENCE_ .
 
 [#LAST]
 === LAST
diff --git 
a/antora/components/refguide-index/modules/applib/pages/index/mixins/dto/Dto.adoc
 
b/antora/components/refguide-index/modules/applib/pages/index/mixins/dto/Dto.adoc
index cee6a25c2c..5e5beb15a9 100644
--- 
a/antora/components/refguide-index/modules/applib/pages/index/mixins/dto/Dto.adoc
+++ 
b/antora/components/refguide-index/modules/applib/pages/index/mixins/dto/Dto.adoc
@@ -3,7 +3,7 @@
 
 Allows JAXB-annotated view models to act as a mixee in order that other 
modules (and the core framework) can contribute behaviour.
 
-A JAXB view model is one annotated with 
_javax.xml.bind.annotation.XmlRootElement_ .
+A JAXB view model is one annotated with 
_jakarta.xml.bind.annotation.XmlRootElement_ .
 
 The two mixin behaviours contributed by the core framework are the ability to 
download the view model as XML (using 
xref:refguide:applib:index/mixins/dto/Dto_downloadXml.adoc[Dto_downloadXml] ) 
and to download the XSD schema for that XML (using 
xref:refguide:applib:index/mixins/dto/Dto_downloadXsd.adoc[Dto_downloadXsd] ).
 
diff --git 
a/antora/components/refguide-index/modules/applib/pages/index/mixins/metamodel/Object_logicalTypeName.adoc
 
b/antora/components/refguide-index/modules/applib/pages/index/mixins/metamodel/Object_logicalTypeName.adoc
index f2cf9c4475..0fb8873495 100644
--- 
a/antora/components/refguide-index/modules/applib/pages/index/mixins/metamodel/Object_logicalTypeName.adoc
+++ 
b/antora/components/refguide-index/modules/applib/pages/index/mixins/metamodel/Object_logicalTypeName.adoc
@@ -1,7 +1,7 @@
 = Object_logicalTypeName
 :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 [...]
 
-Contributes a property exposing the logical object type of the domain object, 
typically as specified by _javax.inject.Named_ .
+Contributes a property exposing the logical object type of the domain object, 
typically as specified by _jakarta.inject.Named_ .
 
 The logical type name is also accessible from the 
_org.apache.causeway.applib.services.bookmark.Bookmark_ of the object.
 
diff --git 
a/antora/components/refguide-index/modules/applib/pages/index/mixins/metamodel/Object_objectIdentifier.adoc
 
b/antora/components/refguide-index/modules/applib/pages/index/mixins/metamodel/Object_objectIdentifier.adoc
index 07d4d812a6..6e08940c64 100644
--- 
a/antora/components/refguide-index/modules/applib/pages/index/mixins/metamodel/Object_objectIdentifier.adoc
+++ 
b/antora/components/refguide-index/modules/applib/pages/index/mixins/metamodel/Object_objectIdentifier.adoc
@@ -1,7 +1,7 @@
 = Object_objectIdentifier
 :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 [...]
 
-Contributes a property exposing the internal identifier of the domain object, 
typically as specified by _javax.inject.Named_ .
+Contributes a property exposing the internal identifier of the domain object, 
typically as specified by _jakarta.inject.Named_ .
 
 The object identifier is also accessible from the 
_org.apache.causeway.applib.services.bookmark.Bookmark_ of the object.
 
diff --git 
a/antora/components/refguide-index/modules/applib/pages/index/services/inject/ServiceInjector.adoc
 
b/antora/components/refguide-index/modules/applib/pages/index/services/inject/ServiceInjector.adoc
index b7b9830ae4..7818bc84f8 100644
--- 
a/antora/components/refguide-index/modules/applib/pages/index/services/inject/ServiceInjector.adoc
+++ 
b/antora/components/refguide-index/modules/applib/pages/index/services/inject/ServiceInjector.adoc
@@ -1,7 +1,7 @@
 = ServiceInjector
 :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 [...]
 
-Resolves injection points using the 
_org.apache.causeway.applib.services.registry.ServiceRegistry_ (in other words 
provides a domain service instance to all fields and setters that are annotated 
with _javax.inject.Inject_ ).
+Resolves injection points using the 
_org.apache.causeway.applib.services.registry.ServiceRegistry_ (in other words 
provides a domain service instance to all fields and setters that are annotated 
with _jakarta.inject.Inject_ ).
 
 == API
 
diff --git 
a/antora/components/refguide-index/modules/applib/pages/index/services/keyvaluestore/KeyValueSessionStore.adoc
 
b/antora/components/refguide-index/modules/applib/pages/index/services/keyvaluestore/KeyValueSessionStore.adoc
index 38d40de88b..accfed2902 100644
--- 
a/antora/components/refguide-index/modules/applib/pages/index/services/keyvaluestore/KeyValueSessionStore.adoc
+++ 
b/antora/components/refguide-index/modules/applib/pages/index/services/keyvaluestore/KeyValueSessionStore.adoc
@@ -1,7 +1,7 @@
 = KeyValueSessionStore
 :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 [...]
 
-Defines a mechanism for viewers to store arbitrary key value pairs on a 
per-session basis. That is usually a _javax.servlet.http.HttpSession_ .
+Defines a mechanism for viewers to store arbitrary key value pairs on a 
per-session basis. That is usually a _jakarta.servlet.http.HttpSession_ .
 
 This store _is_ used by the Wicket viewer. For example, the viewer remembers 
which time-zone the user has logged in. Or when impersonating.
 
diff --git 
a/antora/components/refguide-index/modules/commons/pages/index/functional/ThrowingConsumer.adoc
 
b/antora/components/refguide-index/modules/commons/pages/index/functional/ThrowingConsumer.adoc
deleted file mode 100644
index d1470655c9..0000000000
--- 
a/antora/components/refguide-index/modules/commons/pages/index/functional/ThrowingConsumer.adoc
+++ /dev/null
@@ -1,100 +0,0 @@
-= ThrowingConsumer
-: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 [...]
-
-A _Consumer_ that allows invocation of code that throws a checked _Exception_ .
-
-== API
-
-[source,java]
-.ThrowingConsumer.java
-----
-interface ThrowingConsumer<T> {
-  void acceptWithException(T t)     // <.>
-  void accept(T t)     // <.>
-  void accept(T t, BiFunction<String, Exception, RuntimeException> 
exceptionWrapper)     // <.>
-  ThrowingConsumer<T> throwing(BiFunction<String, Exception, RuntimeException> 
exceptionWrapper)     // <.>
-  ThrowingConsumer<T> of(ThrowingConsumer<T> consumer)     // <.>
-  ThrowingConsumer<T> of(ThrowingConsumer<T> consumer, BiFunction<String, 
Exception, RuntimeException> exceptionWrapper)     // <.>
-}
-----
-
-<.> xref:#acceptWithException_T[acceptWithException(T)]
-+
---
-Performs this operation on the given argument, possibly throwing a checked 
exception.
---
-<.> xref:#accept_T[accept(T)]
-+
---
-Default _Consumer#accept(Object)_ that wraps any thrown checked exceptions (by 
default in a _RuntimeException_ ).
---
-<.> xref:#accept_T_BiFunction[accept(T, BiFunction)]
-+
---
-Performs this operation on the given argument, wrapping any thrown checked 
exceptions using the given _exceptionWrapper_ .
---
-<.> xref:#throwing_BiFunction[throwing(BiFunction)]
-+
---
-Return a new 
xref:refguide:commons:index/functional/ThrowingConsumer.adoc[ThrowingConsumer] 
where the _#accept(Object)_ method wraps any thrown checked exceptions using 
the given _exceptionWrapper_ .
---
-<.> xref:#of_ThrowingConsumer[of(ThrowingConsumer)]
-+
---
-Lambda friendly convenience method that can be used to create a 
xref:refguide:commons:index/functional/ThrowingConsumer.adoc[ThrowingConsumer] 
where the _#accept(Object)_ method wraps any checked exception thrown by the 
supplied lambda expression or method reference.
---
-<.> xref:#of_ThrowingConsumer_BiFunction[of(ThrowingConsumer, BiFunction)]
-+
---
-Lambda friendly convenience method that can be used to create a 
xref:refguide:commons:index/functional/ThrowingConsumer.adoc[ThrowingConsumer] 
where the _#accept(Object)_ method wraps any thrown checked exceptions using 
the given _exceptionWrapper_ .
---
-
-== Members
-
-[#acceptWithException_T]
-=== acceptWithException(T)
-
-Performs this operation on the given argument, possibly throwing a checked 
exception.
-
-[#accept_T]
-=== accept(T)
-
-Default _Consumer#accept(Object)_ that wraps any thrown checked exceptions (by 
default in a _RuntimeException_ ).
-
-[#accept_T_BiFunction]
-=== accept(T, BiFunction)
-
-Performs this operation on the given argument, wrapping any thrown checked 
exceptions using the given _exceptionWrapper_ .
-
-[#throwing_BiFunction]
-=== throwing(BiFunction)
-
-Return a new 
xref:refguide:commons:index/functional/ThrowingConsumer.adoc[ThrowingConsumer] 
where the _#accept(Object)_ method wraps any thrown checked exceptions using 
the given _exceptionWrapper_ .
-
-[#of_ThrowingConsumer]
-=== of(ThrowingConsumer)
-
-Lambda friendly convenience method that can be used to create a 
xref:refguide:commons:index/functional/ThrowingConsumer.adoc[ThrowingConsumer] 
where the _#accept(Object)_ method wraps any checked exception thrown by the 
supplied lambda expression or method reference.
-
-This method can be especially useful when working with method references. It 
allows you to easily convert a method that throws a checked exception into an 
instance compatible with a regular _Consumer_ .
-
-For example:
-
-----
-
-list.forEach(ThrowingConsumer.of(Example::methodThatCanThrowCheckedException));
-----
-
-[#of_ThrowingConsumer_BiFunction]
-=== of(ThrowingConsumer, BiFunction)
-
-Lambda friendly convenience method that can be used to create a 
xref:refguide:commons:index/functional/ThrowingConsumer.adoc[ThrowingConsumer] 
where the _#accept(Object)_ method wraps any thrown checked exceptions using 
the given _exceptionWrapper_ .
-
-This method can be especially useful when working with method references. It 
allows you to easily convert a method that throws a checked exception into an 
instance compatible with a regular _Consumer_ .
-
-For example:
-
-----
-
-list.forEach(ThrowingConsumer.of(Example::methodThatCanThrowCheckedException, 
IllegalStateException::new));
-----
diff --git 
a/antora/components/refguide-index/modules/commons/pages/index/functional/ThrowingSupplier.adoc
 
b/antora/components/refguide-index/modules/commons/pages/index/functional/ThrowingSupplier.adoc
deleted file mode 100644
index 53d69dc489..0000000000
--- 
a/antora/components/refguide-index/modules/commons/pages/index/functional/ThrowingSupplier.adoc
+++ /dev/null
@@ -1,100 +0,0 @@
-= ThrowingSupplier
-: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 [...]
-
-A _Supplier_ that allows invocation of code that throws a checked exception.
-
-== API
-
-[source,java]
-.ThrowingSupplier.java
-----
-interface ThrowingSupplier<T> {
-  T getWithException()     // <.>
-  T get()     // <.>
-  T get(BiFunction<String, Exception, RuntimeException> exceptionWrapper)     
// <.>
-  ThrowingSupplier<T> throwing(BiFunction<String, Exception, RuntimeException> 
exceptionWrapper)     // <.>
-  ThrowingSupplier<T> of(ThrowingSupplier<T> supplier)     // <.>
-  ThrowingSupplier<T> of(ThrowingSupplier<T> supplier, BiFunction<String, 
Exception, RuntimeException> exceptionWrapper)     // <.>
-}
-----
-
-<.> xref:#getWithException_[getWithException()]
-+
---
-Gets a result, possibly throwing a checked exception.
---
-<.> xref:#get_[get()]
-+
---
-Default _Supplier#get()_ that wraps any thrown checked exceptions (by default 
in a _RuntimeException_ ).
---
-<.> xref:#get_BiFunction[get(BiFunction)]
-+
---
-Gets a result, wrapping any thrown checked exceptions using the given 
_exceptionWrapper_ .
---
-<.> xref:#throwing_BiFunction[throwing(BiFunction)]
-+
---
-Return a new 
xref:refguide:commons:index/functional/ThrowingSupplier.adoc[ThrowingSupplier] 
where the _#get()_ method wraps any thrown checked exceptions using the given 
_exceptionWrapper_ .
---
-<.> xref:#of_ThrowingSupplier[of(ThrowingSupplier)]
-+
---
-Lambda friendly convenience method that can be used to create a 
xref:refguide:commons:index/functional/ThrowingSupplier.adoc[ThrowingSupplier] 
where the _#get()_ method wraps any checked exception thrown by the supplied 
lambda expression or method reference.
---
-<.> xref:#of_ThrowingSupplier_BiFunction[of(ThrowingSupplier, BiFunction)]
-+
---
-Lambda friendly convenience method that can be used to create 
xref:refguide:commons:index/functional/ThrowingSupplier.adoc[ThrowingSupplier] 
where the _#get()_ method wraps any thrown checked exceptions using the given 
_exceptionWrapper_ .
---
-
-== Members
-
-[#getWithException_]
-=== getWithException()
-
-Gets a result, possibly throwing a checked exception.
-
-[#get_]
-=== get()
-
-Default _Supplier#get()_ that wraps any thrown checked exceptions (by default 
in a _RuntimeException_ ).
-
-[#get_BiFunction]
-=== get(BiFunction)
-
-Gets a result, wrapping any thrown checked exceptions using the given 
_exceptionWrapper_ .
-
-[#throwing_BiFunction]
-=== throwing(BiFunction)
-
-Return a new 
xref:refguide:commons:index/functional/ThrowingSupplier.adoc[ThrowingSupplier] 
where the _#get()_ method wraps any thrown checked exceptions using the given 
_exceptionWrapper_ .
-
-[#of_ThrowingSupplier]
-=== of(ThrowingSupplier)
-
-Lambda friendly convenience method that can be used to create a 
xref:refguide:commons:index/functional/ThrowingSupplier.adoc[ThrowingSupplier] 
where the _#get()_ method wraps any checked exception thrown by the supplied 
lambda expression or method reference.
-
-This method can be especially useful when working with method references. It 
allows you to easily convert a method that throws a checked exception into an 
instance compatible with a regular _Supplier_ .
-
-For example:
-
-----
-
-optional.orElseGet(ThrowingSupplier.of(Example::methodThatCanThrowCheckedException));
-----
-
-[#of_ThrowingSupplier_BiFunction]
-=== of(ThrowingSupplier, BiFunction)
-
-Lambda friendly convenience method that can be used to create 
xref:refguide:commons:index/functional/ThrowingSupplier.adoc[ThrowingSupplier] 
where the _#get()_ method wraps any thrown checked exceptions using the given 
_exceptionWrapper_ .
-
-This method can be especially useful when working with method references. It 
allows you to easily convert a method that throws a checked exception into an 
instance compatible with a regular _Supplier_ .
-
-For example:
-
-----
-
-optional.orElseGet(ThrowingSupplier.of(Example::methodThatCanThrowCheckedException,
 IllegalStateException::new));
-----
diff --git 
a/antora/components/refguide-index/modules/commons/pages/index/io/JsonUtils.adoc
 
b/antora/components/refguide-index/modules/commons/pages/index/io/JsonUtils.adoc
index 4a407452c9..59f7349d13 100644
--- 
a/antora/components/refguide-index/modules/commons/pages/index/io/JsonUtils.adoc
+++ 
b/antora/components/refguide-index/modules/commons/pages/index/io/JsonUtils.adoc
@@ -9,6 +9,7 @@ Utilities to convert from and to JSON format.
 .JsonUtils.java
 ----
 class JsonUtils {
+  Optional<Class<?>> getPlatformDefaultJsonProviderForJaxb()     // <.>
   Try<T> tryRead(Class<T> mappedType, String stringUtf8, 
JsonUtils.JacksonCustomizer... customizers)     // <.>
   Try<T> tryRead(Class<T> mappedType, DataSource source, 
JsonUtils.JacksonCustomizer... customizers)     // <.>
   Try<List<T>> tryReadAsList(Class<T> elementType, DataSource source, 
JsonUtils.JacksonCustomizer... customizers)     // <.>
@@ -24,6 +25,11 @@ class JsonUtils {
 }
 ----
 
+<.> 
xref:#getPlatformDefaultJsonProviderForJaxb_[getPlatformDefaultJsonProviderForJaxb()]
++
+--
+Consumers of the framework may choose to use a different provider.
+--
 <.> xref:#tryRead_Class_String_JsonUtils_JacksonCustomizer[tryRead(Class, 
String, JsonUtils_JacksonCustomizer)]
 +
 --
@@ -87,6 +93,11 @@ add support for writing Can
 
 == Members
 
+[#getPlatformDefaultJsonProviderForJaxb_]
+=== getPlatformDefaultJsonProviderForJaxb()
+
+Consumers of the framework may choose to use a different provider.
+
 [#tryRead_Class_String_JsonUtils_JacksonCustomizer]
 === tryRead(Class, String, JsonUtils_JacksonCustomizer)
 
diff --git 
a/antora/components/refguide-index/modules/commons/pages/index/io/YamlUtils.adoc
 
b/antora/components/refguide-index/modules/commons/pages/index/io/YamlUtils.adoc
index 62a906c921..2c246a3a70 100644
--- 
a/antora/components/refguide-index/modules/commons/pages/index/io/YamlUtils.adoc
+++ 
b/antora/components/refguide-index/modules/commons/pages/index/io/YamlUtils.adoc
@@ -11,8 +11,12 @@ Utilities to convert from and to YAML format.
 class YamlUtils {
   Try<T> tryRead(Class<T> mappedType, String stringUtf8, 
JsonUtils.JacksonCustomizer... customizers)     // <.>
   Try<T> tryRead(Class<T> mappedType, DataSource source, 
JsonUtils.JacksonCustomizer... customizers)     // <.>
+  Try<T> tryReadCustomized(Class<T> mappedType, String stringUtf8, 
YamlLoadCustomizer loadCustomizer, JsonUtils.JacksonCustomizer... customizers)  
   // <.>
+  Try<T> tryReadCustomized(Class<T> mappedType, DataSource source, 
YamlLoadCustomizer loadCustomizer, JsonUtils.JacksonCustomizer... customizers)  
   // <.>
   void write(Object pojo, DataSink sink, JsonUtils.JacksonCustomizer... 
customizers)     // <.>
   String toStringUtf8(Object pojo, JsonUtils.JacksonCustomizer... customizers) 
    // <.>
+  void writeCustomized(Object pojo, DataSink sink, YamlDumpCustomizer 
dumpCustomizer, JsonUtils.JacksonCustomizer... customizers)     // <.>
+  String toStringUtf8Customized(Object pojo, YamlDumpCustomizer 
dumpCustomizer, JsonUtils.JacksonCustomizer... customizers)     // <.>
   DumperOptions allowReadOnlyProperties(DumperOptions opts)     // <.>
 }
 ----
@@ -27,6 +31,16 @@ Tries to deserialize YAML content from given UTF8 encoded 
_String_ into an insta
 --
 Tries to deserialize YAML content from given 
xref:refguide:commons:index/io/DataSource.adoc[DataSource] into an instance of 
given _requiredType_ .
 --
+<.> 
xref:#tryReadCustomized_Class_String_YamlLoadCustomizer_JsonUtils_JacksonCustomizer[tryReadCustomized(Class,
 String, YamlLoadCustomizer, JsonUtils_JacksonCustomizer)]
++
+--
+Tries to deserialize YAML content from given UTF8 encoded _String_ into an 
instance of given _mappedType_ .
+--
+<.> 
xref:#tryReadCustomized_Class_DataSource_YamlLoadCustomizer_JsonUtils_JacksonCustomizer[tryReadCustomized(Class,
 DataSource, YamlLoadCustomizer, JsonUtils_JacksonCustomizer)]
++
+--
+Tries to deserialize YAML content from given 
xref:refguide:commons:index/io/DataSource.adoc[DataSource] into an instance of 
given _requiredType_ .
+--
 <.> xref:#write_Object_DataSink_JsonUtils_JacksonCustomizer[write(Object, 
DataSink, JsonUtils_JacksonCustomizer)]
 +
 --
@@ -37,6 +51,16 @@ Writes given _pojo_ to given 
xref:refguide:commons:index/io/DataSink.adoc[DataSi
 --
 Converts given _pojo_ to an UTF8 encoded _String_ .
 --
+<.> 
xref:#writeCustomized_Object_DataSink_YamlDumpCustomizer_JsonUtils_JacksonCustomizer[writeCustomized(Object,
 DataSink, YamlDumpCustomizer, JsonUtils_JacksonCustomizer)]
++
+--
+Writes given _pojo_ to given 
xref:refguide:commons:index/io/DataSink.adoc[DataSink] .
+--
+<.> 
xref:#toStringUtf8Customized_Object_YamlDumpCustomizer_JsonUtils_JacksonCustomizer[toStringUtf8Customized(Object,
 YamlDumpCustomizer, JsonUtils_JacksonCustomizer)]
++
+--
+Converts given _pojo_ to an UTF8 encoded _String_ .
+--
 <.> 
xref:#allowReadOnlyProperties_DumperOptions[allowReadOnlyProperties(DumperOptions)]
 +
 --
@@ -55,6 +79,16 @@ Tries to deserialize YAML content from given UTF8 encoded 
_String_ into an insta
 
 Tries to deserialize YAML content from given 
xref:refguide:commons:index/io/DataSource.adoc[DataSource] into an instance of 
given _requiredType_ .
 
+[#tryReadCustomized_Class_String_YamlLoadCustomizer_JsonUtils_JacksonCustomizer]
+=== tryReadCustomized(Class, String, YamlLoadCustomizer, 
JsonUtils_JacksonCustomizer)
+
+Tries to deserialize YAML content from given UTF8 encoded _String_ into an 
instance of given _mappedType_ .
+
+[#tryReadCustomized_Class_DataSource_YamlLoadCustomizer_JsonUtils_JacksonCustomizer]
+=== tryReadCustomized(Class, DataSource, YamlLoadCustomizer, 
JsonUtils_JacksonCustomizer)
+
+Tries to deserialize YAML content from given 
xref:refguide:commons:index/io/DataSource.adoc[DataSource] into an instance of 
given _requiredType_ .
+
 [#write_Object_DataSink_JsonUtils_JacksonCustomizer]
 === write(Object, DataSink, JsonUtils_JacksonCustomizer)
 
@@ -65,6 +99,16 @@ Writes given _pojo_ to given 
xref:refguide:commons:index/io/DataSink.adoc[DataSi
 
 Converts given _pojo_ to an UTF8 encoded _String_ .
 
+[#writeCustomized_Object_DataSink_YamlDumpCustomizer_JsonUtils_JacksonCustomizer]
+=== writeCustomized(Object, DataSink, YamlDumpCustomizer, 
JsonUtils_JacksonCustomizer)
+
+Writes given _pojo_ to given 
xref:refguide:commons:index/io/DataSink.adoc[DataSink] .
+
+[#toStringUtf8Customized_Object_YamlDumpCustomizer_JsonUtils_JacksonCustomizer]
+=== toStringUtf8Customized(Object, YamlDumpCustomizer, 
JsonUtils_JacksonCustomizer)
+
+Converts given _pojo_ to an UTF8 encoded _String_ .
+
 [#allowReadOnlyProperties_DumperOptions]
 === allowReadOnlyProperties(DumperOptions)
 
diff --git 
a/antora/components/refguide-index/modules/persistence/pages/index/jdo/applib/types/Money.adoc
 
b/antora/components/refguide-index/modules/persistence/pages/index/jdo/applib/types/Money.adoc
index 1f82a6adb5..dd939a0163 100644
--- 
a/antora/components/refguide-index/modules/persistence/pages/index/jdo/applib/types/Money.adoc
+++ 
b/antora/components/refguide-index/modules/persistence/pages/index/jdo/applib/types/Money.adoc
@@ -21,9 +21,9 @@ String columnAllowsNull() default "true";
 int columnLength() default Money.INTEGER + Money.FRACTION;
   @AliasFor(annotation = javax.jdo.annotations.Column.class, attribute = 
"scale")
 int columnScale() default Money.FRACTION;
-  @AliasFor(annotation = javax.validation.constraints.Digits.class, attribute 
= "integer")
+  @AliasFor(annotation = jakarta.validation.constraints.Digits.class, 
attribute = "integer")
 int digitsInteger() default Money.INTEGER;
-  @AliasFor(annotation = javax.validation.constraints.Digits.class, attribute 
= "fraction")
+  @AliasFor(annotation = jakarta.validation.constraints.Digits.class, 
attribute = "fraction")
 int digitsFraction() default Money.FRACTION;
 }
 ----
diff --git 
a/antora/components/refguide-index/modules/persistence/pages/index/jdo/applib/types/Percentage.adoc
 
b/antora/components/refguide-index/modules/persistence/pages/index/jdo/applib/types/Percentage.adoc
index 23f84ad6c1..a44d3f8e3c 100644
--- 
a/antora/components/refguide-index/modules/persistence/pages/index/jdo/applib/types/Percentage.adoc
+++ 
b/antora/components/refguide-index/modules/persistence/pages/index/jdo/applib/types/Percentage.adoc
@@ -21,9 +21,9 @@ String columnAllowsNull() default "true";
 int columnLength() default Percentage.INTEGER + Percentage.FRACTION;
   @AliasFor(annotation = javax.jdo.annotations.Column.class, attribute = 
"scale")
 int columnScale() default Percentage.FRACTION;
-  @AliasFor(annotation = javax.validation.constraints.Digits.class, attribute 
= "integer")
+  @AliasFor(annotation = jakarta.validation.constraints.Digits.class, 
attribute = "integer")
 int digitsInteger() default Percentage.INTEGER;
-  @AliasFor(annotation = javax.validation.constraints.Digits.class, attribute 
= "fraction")
+  @AliasFor(annotation = jakarta.validation.constraints.Digits.class, 
attribute = "fraction")
 int digitsFraction() default Percentage.FRACTION;
 }
 ----
diff --git 
a/antora/components/refguide-index/modules/persistence/pages/index/jpa/applib/integration/CausewayEntityListener.adoc
 
b/antora/components/refguide-index/modules/persistence/pages/index/jpa/applib/integration/CausewayEntityListener.adoc
index 6c10ee6bcc..6a81cec7c8 100644
--- 
a/antora/components/refguide-index/modules/persistence/pages/index/jpa/applib/integration/CausewayEntityListener.adoc
+++ 
b/antora/components/refguide-index/modules/persistence/pages/index/jpa/applib/integration/CausewayEntityListener.adoc
@@ -1,7 +1,7 @@
 = CausewayEntityListener
 :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 [...]
 
-EntityListener class for listing with the _javax.persistence.EntityListeners_ 
annotation, to support injection point resolving for entities, and to notify 
_ObjectLifecyclePublisher_ of changes.
+EntityListener class for listing with the 
_jakarta.persistence.EntityListeners_ annotation, to support injection point 
resolving for entities, and to notify _ObjectLifecyclePublisher_ of changes.
 
 Instances of this class are not managed by Spring, but by the persistence 
layer.
 
diff --git 
a/antora/components/refguide-index/modules/persistence/pages/index/jpa/applib/types/BlobJpaEmbeddable.adoc
 
b/antora/components/refguide-index/modules/persistence/pages/index/jpa/applib/types/BlobJpaEmbeddable.adoc
index 1d982f98d1..d075524eac 100644
--- 
a/antora/components/refguide-index/modules/persistence/pages/index/jpa/applib/types/BlobJpaEmbeddable.adoc
+++ 
b/antora/components/refguide-index/modules/persistence/pages/index/jpa/applib/types/BlobJpaEmbeddable.adoc
@@ -27,7 +27,7 @@ Example usage:
    
 ----
 
-Lastly; note that _javax.persistence.AttributeOverrides_ and 
_javax.persistence.AttributeOverride_ provide a standardised way of fine-tuning 
the column definitions.
+Lastly; note that _jakarta.persistence.AttributeOverrides_ and 
_jakarta.persistence.AttributeOverride_ provide a standardised way of 
fine-tuning the column definitions.
 
 == API
 
diff --git 
a/antora/components/refguide-index/modules/persistence/pages/index/jpa/applib/types/ClobJpaEmbeddable.adoc
 
b/antora/components/refguide-index/modules/persistence/pages/index/jpa/applib/types/ClobJpaEmbeddable.adoc
index 18df8ffaf9..88247b0d06 100644
--- 
a/antora/components/refguide-index/modules/persistence/pages/index/jpa/applib/types/ClobJpaEmbeddable.adoc
+++ 
b/antora/components/refguide-index/modules/persistence/pages/index/jpa/applib/types/ClobJpaEmbeddable.adoc
@@ -27,7 +27,7 @@ Example usage:
    
 ----
 
-Lastly; note that _javax.persistence.AttributeOverrides_ and 
_javax.persistence.AttributeOverride_ provide a standardised way of fine-tuning 
the column definitions.
+Lastly; note that _jakarta.persistence.AttributeOverrides_ and 
_jakarta.persistence.AttributeOverride_ provide a standardised way of 
fine-tuning the column definitions.
 
 == API
 
diff --git 
a/antora/components/refguide-index/modules/security/pages/index/keycloak/CausewayModuleSecurityKeycloak.adoc
 
b/antora/components/refguide-index/modules/security/pages/index/keycloak/CausewayModuleSecurityKeycloak.adoc
index f0cbcf32b3..86b7a74771 100644
--- 
a/antora/components/refguide-index/modules/security/pages/index/keycloak/CausewayModuleSecurityKeycloak.adoc
+++ 
b/antora/components/refguide-index/modules/security/pages/index/keycloak/CausewayModuleSecurityKeycloak.adoc
@@ -9,7 +9,7 @@ Configuration Bean to support Causeway Security using Keycloak.
 .CausewayModuleSecurityKeycloak.java
 ----
 class CausewayModuleSecurityKeycloak {
-  WebSecurityConfigurerAdapter webSecurityConfigurer(CausewayConfiguration 
causewayConfiguration, KeycloakOauth2UserService keycloakOidcUserService, 
List<LoginSuccessHandlerUNUSED> loginSuccessHandlersUNUSED, List<LogoutHandler> 
logoutHandlers)
+  SecurityFilterChain filterChain(HttpSecurity http, CausewayConfiguration 
causewayConfiguration, KeycloakOauth2UserService keycloakOidcUserService, 
List<LoginSuccessHandlerUNUSED> loginSuccessHandlersUNUSED, List<LogoutHandler> 
logoutHandlers)
   KeycloakOauth2UserService keycloakOidcUserService(OAuth2ClientProperties 
oauth2ClientProperties, CausewayConfiguration causewayConfiguration)
 }
 ----
diff --git 
a/antora/components/refguide-index/modules/security/pages/index/shiro/webmodule/WebModuleShiro.adoc
 
b/antora/components/refguide-index/modules/security/pages/index/shiro/webmodule/WebModuleShiro.adoc
index a3edf9ef22..ae985e1631 100644
--- 
a/antora/components/refguide-index/modules/security/pages/index/shiro/webmodule/WebModuleShiro.adoc
+++ 
b/antora/components/refguide-index/modules/security/pages/index/shiro/webmodule/WebModuleShiro.adoc
@@ -12,7 +12,6 @@ Can be customized via static 
_WebModuleShiro#setShiroEnvironmentClass(Class)_
 ----
 class WebModuleShiro {
   WebModuleShiro(ServiceInjector serviceInjector)
-  void setShiroEnvironmentClass(Class<? extends WebEnvironment> 
shiroEnvironmentClass)
   void setShiroIniResource(String resourcePath)
   void prepare(WebModuleContext ctx)
   Can<ServletContextListener> init(ServletContext ctx)
diff --git 
a/antora/components/refguide-index/modules/security/pages/index/spring/authconverters/AuthenticationConverter.adoc
 
b/antora/components/refguide-index/modules/security/pages/index/spring/authconverters/AuthenticationConverter.adoc
index 0ae8c5c4b1..99019c4905 100644
--- 
a/antora/components/refguide-index/modules/security/pages/index/spring/authconverters/AuthenticationConverter.adoc
+++ 
b/antora/components/refguide-index/modules/security/pages/index/spring/authconverters/AuthenticationConverter.adoc
@@ -7,7 +7,7 @@ The _Authentication_ will have already been verified as having 
been _Authenticat
 
 Implementations should be defined as Spring _Component_ s and added to the 
_Configuration application context_ either by being _Import imported_ 
explicitly or implicitly through _ComponentScan_ .
 
-All known converters are checked one by one, but checking stops once one 
converter has successively converted the _Authentication_ into a 
xref:refguide:applib:index/services/user/UserMemento.adoc[UserMemento] (in 
other words, chain-of-responsibility pattern). Use the 
_javax.annotation.Priority_ annotation to influence the order in which 
converter implementations are checked.
+All known converters are checked one by one, but checking stops once one 
converter has successively converted the _Authentication_ into a 
xref:refguide:applib:index/services/user/UserMemento.adoc[UserMemento] (in 
other words, chain-of-responsibility pattern). Use the 
_jakarta.annotation.Priority_ annotation to influence the order in which 
converter implementations are checked.
 
 == API
 
diff --git 
a/antora/components/refguide-index/modules/testing/pages/index/archtestsupport/applib/classrules/ArchitectureDomainRules.adoc
 
b/antora/components/refguide-index/modules/testing/pages/index/archtestsupport/applib/classrules/ArchitectureDomainRules.adoc
index 32ca52d260..b144eb8e18 100644
--- 
a/antora/components/refguide-index/modules/testing/pages/index/archtestsupport/applib/classrules/ArchitectureDomainRules.adoc
+++ 
b/antora/components/refguide-index/modules/testing/pages/index/archtestsupport/applib/classrules/ArchitectureDomainRules.adoc
@@ -88,12 +88,12 @@ This rule requires that classes named `XxxController` 
should also be annotated w
 <.> 
xref:#every_injected_field_of_jaxb_view_model_must_be_annotated_with_XmlTransient_[every_injected_field_of_jaxb_view_model_must_be_annotated_with_XmlTransient()]
 +
 --
-This rule requires that injected fields in jaxb view models (that is, classes 
annotated with the JAXB _javax.xml.bind.annotation.XmlRootElement_ annotation) 
must also be annotated with JAXB _javax.xml.bind.annotation.XmlTransient_ 
annotation.
+This rule requires that injected fields in jaxb view models (that is, classes 
annotated with the JAXB _jakarta.xml.bind.annotation.XmlRootElement_ 
annotation) must also be annotated with JAXB 
_jakarta.xml.bind.annotation.XmlTransient_ annotation.
 --
 <.> 
xref:#every_injected_field_of_serializable_view_model_must_be_transient_[every_injected_field_of_serializable_view_model_must_be_transient()]
 +
 --
-This rule requires that injected fields in jaxb view models (that is, classes 
annotated with the JAXB _javax.xml.bind.annotation.XmlRootElement_ annotation) 
must also be annotated with JAXB _javax.xml.bind.annotation.XmlTransient_ 
annotation.
+This rule requires that injected fields in jaxb view models (that is, classes 
annotated with the JAXB _jakarta.xml.bind.annotation.XmlRootElement_ 
annotation) must also be annotated with JAXB 
_jakarta.xml.bind.annotation.XmlTransient_ annotation.
 --
 <.> 
xref:#every_finder_method_in_Repository_must_return_either_Collection_or_Optional_[every_finder_method_in_Repository_must_return_either_Collection_or_Optional()]
 +
@@ -177,14 +177,14 @@ The rationale is so that the pattern is easy to spot and 
to search for,
 [#every_injected_field_of_jaxb_view_model_must_be_annotated_with_XmlTransient_]
 === 
every_injected_field_of_jaxb_view_model_must_be_annotated_with_XmlTransient()
 
-This rule requires that injected fields in jaxb view models (that is, classes 
annotated with the JAXB _javax.xml.bind.annotation.XmlRootElement_ annotation) 
must also be annotated with JAXB _javax.xml.bind.annotation.XmlTransient_ 
annotation.
+This rule requires that injected fields in jaxb view models (that is, classes 
annotated with the JAXB _jakarta.xml.bind.annotation.XmlRootElement_ 
annotation) must also be annotated with JAXB 
_jakarta.xml.bind.annotation.XmlTransient_ annotation.
 
 The rationale here is that injected services are managed by the runtime and 
are not/cannot be serialized to XML.
 
 [#every_injected_field_of_serializable_view_model_must_be_transient_]
 === every_injected_field_of_serializable_view_model_must_be_transient()
 
-This rule requires that injected fields in jaxb view models (that is, classes 
annotated with the JAXB _javax.xml.bind.annotation.XmlRootElement_ annotation) 
must also be annotated with JAXB _javax.xml.bind.annotation.XmlTransient_ 
annotation.
+This rule requires that injected fields in jaxb view models (that is, classes 
annotated with the JAXB _jakarta.xml.bind.annotation.XmlRootElement_ 
annotation) must also be annotated with JAXB 
_jakarta.xml.bind.annotation.XmlTransient_ annotation.
 
 The rationale here is that injected services are managed by the runtime and 
are not/cannot be serialized to XML.
 
diff --git 
a/antora/components/refguide-index/modules/testing/pages/index/archtestsupport/applib/classrules/ArchitectureJdoRules.adoc
 
b/antora/components/refguide-index/modules/testing/pages/index/archtestsupport/applib/classrules/ArchitectureJdoRules.adoc
index d0570aecff..2ec160f1ec 100644
--- 
a/antora/components/refguide-index/modules/testing/pages/index/archtestsupport/applib/classrules/ArchitectureJdoRules.adoc
+++ 
b/antora/components/refguide-index/modules/testing/pages/index/archtestsupport/applib/classrules/ArchitectureJdoRules.adoc
@@ -38,7 +38,7 @@ This rule requires that classes annotated with the JDO 
_javax.jdo.annotations.Pe
 <.> 
xref:#every_jdo_PersistenceCapable_must_be_annotated_as_XmlJavaAdapter_PersistentEntityAdapter_[every_jdo_PersistenceCapable_must_be_annotated_as_XmlJavaAdapter_PersistentEntityAdapter()]
 +
 --
-This rule requires that classes annotated with the JDO 
_javax.jdo.annotations.PersistenceCapable_ annotation must also be annotated 
with the Apache Causeway 
_javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter_ annotation with a value 
of _org.apache.causeway.applib.jaxb.PersistentEntityAdapter_ `.class` .
+This rule requires that classes annotated with the JDO 
_javax.jdo.annotations.PersistenceCapable_ annotation must also be annotated 
with the Apache Causeway 
_jakarta.xml.bind.annotation.adapters.XmlJavaTypeAdapter_ annotation with a 
value of _org.apache.causeway.applib.jaxb.PersistentEntityAdapter_ `.class` .
 --
 <.> 
xref:#every_jdo_PersistenceCapable_must_implement_Comparable_[every_jdo_PersistenceCapable_must_implement_Comparable()]
 +
@@ -83,7 +83,7 @@ The rule does _not_ apply to any entities that are subtype 
entities where there
 
[#every_jdo_PersistenceCapable_must_be_annotated_as_XmlJavaAdapter_PersistentEntityAdapter_]
 === 
every_jdo_PersistenceCapable_must_be_annotated_as_XmlJavaAdapter_PersistentEntityAdapter()
 
-This rule requires that classes annotated with the JDO 
_javax.jdo.annotations.PersistenceCapable_ annotation must also be annotated 
with the Apache Causeway 
_javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter_ annotation with a value 
of _org.apache.causeway.applib.jaxb.PersistentEntityAdapter_ `.class` .
+This rule requires that classes annotated with the JDO 
_javax.jdo.annotations.PersistenceCapable_ annotation must also be annotated 
with the Apache Causeway 
_jakarta.xml.bind.annotation.adapters.XmlJavaTypeAdapter_ annotation with a 
value of _org.apache.causeway.applib.jaxb.PersistentEntityAdapter_ `.class` .
 
 Tnis is so that entities can be transparently referenced from XML-style view 
models.
 
diff --git 
a/antora/components/refguide-index/modules/testing/pages/index/archtestsupport/applib/classrules/ArchitectureJpaRules.adoc
 
b/antora/components/refguide-index/modules/testing/pages/index/archtestsupport/applib/classrules/ArchitectureJpaRules.adoc
index d63b6adfcc..9c2a7d33e0 100644
--- 
a/antora/components/refguide-index/modules/testing/pages/index/archtestsupport/applib/classrules/ArchitectureJpaRules.adoc
+++ 
b/antora/components/refguide-index/modules/testing/pages/index/archtestsupport/applib/classrules/ArchitectureJpaRules.adoc
@@ -37,12 +37,12 @@ This rule requires that classes annotated with the JPA 
_Entity_ annotation must
 <.> 
xref:#every_jpa_Entity_must_be_annotated_with_XmlJavaAdapter_of_PersistentEntityAdapter_[every_jpa_Entity_must_be_annotated_with_XmlJavaAdapter_of_PersistentEntityAdapter()]
 +
 --
-This rule requires that classes annotated with the JPA _Entity_ annotation 
must also be annotated with the Apache Causeway 
_javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter_ annotation with a value 
of _org.apache.causeway.applib.jaxb.PersistentEntityAdapter_ `.class` .
+This rule requires that classes annotated with the JPA _Entity_ annotation 
must also be annotated with the Apache Causeway 
_jakarta.xml.bind.annotation.adapters.XmlJavaTypeAdapter_ annotation with a 
value of _org.apache.causeway.applib.jaxb.PersistentEntityAdapter_ `.class` .
 --
 <.> 
xref:#every_jpa_Entity_must_be_annotated_as_an_CausewayEntityListener_[every_jpa_Entity_must_be_annotated_as_an_CausewayEntityListener()]
 +
 --
-This rule requires that classes annotated with the JPA _Entity_ annotation 
must also be annotated with the _javax.persistence.EntityListeners_ annotation 
that includes a value of 
`org.apache.causeway.persistence.jpa.applib.integration.CausewayEntityListener.class`
 .
+This rule requires that classes annotated with the JPA _Entity_ annotation 
must also be annotated with the _jakarta.persistence.EntityListeners_ 
annotation that includes a value of 
`org.apache.causeway.persistence.jpa.applib.integration.CausewayEntityListener.class`
 .
 --
 <.> 
xref:#every_jpa_Entity_must_implement_Comparable_[every_jpa_Entity_must_implement_Comparable()]
 +
@@ -62,7 +62,7 @@ This rule requires that classes annotated with the JPA 
_Entity_ annotation must
 <.> 
xref:#every_enum_field_of_jpa_Entity_must_be_annotated_with_Enumerable_STRING_[every_enum_field_of_jpa_Entity_must_be_annotated_with_Enumerable_STRING()]
 +
 --
-This rule requires that enum fields in classes annotated with the JPA _Entity_ 
annotation must also be annotated with the JPA _Enumerated_ annotation 
indicating that they should be persisted as _javax.persistence.EnumType#STRING 
string_ s (rather than ordinal numbers).
+This rule requires that enum fields in classes annotated with the JPA _Entity_ 
annotation must also be annotated with the JPA _Enumerated_ annotation 
indicating that they should be persisted as 
_jakarta.persistence.EnumType#STRING string_ s (rather than ordinal numbers).
 --
 <.> 
xref:#every_injected_field_of_jpa_Entity_must_be_annotated_with_Transient_[every_injected_field_of_jpa_Entity_must_be_annotated_with_Transient()]
 +
@@ -77,7 +77,7 @@ This rule requires that classes annotated with the JPA 
_Entity_ annotation must
 <.> 
xref:#every_jpa_Entity_must_have_a_version_field_[every_jpa_Entity_must_have_a_version_field()]
 +
 --
-This rule requires that classes annotated with the JPA _Entity_ annotation 
must contain a `version` field that is itself annotated with 
_javax.persistence.Version_ .
+This rule requires that classes annotated with the JPA _Entity_ annotation 
must contain a `version` field that is itself annotated with 
_jakarta.persistence.Version_ .
 --
 <.> 
xref:#every_jpa_Entity_must_have_protected_no_arg_constructor_[every_jpa_Entity_must_have_protected_no_arg_constructor()]
 +
@@ -95,14 +95,14 @@ This rule requires that classes annotated with the JPA 
_Entity_ annotation must
 
[#every_jpa_Entity_must_be_annotated_with_XmlJavaAdapter_of_PersistentEntityAdapter_]
 === 
every_jpa_Entity_must_be_annotated_with_XmlJavaAdapter_of_PersistentEntityAdapter()
 
-This rule requires that classes annotated with the JPA _Entity_ annotation 
must also be annotated with the Apache Causeway 
_javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter_ annotation with a value 
of _org.apache.causeway.applib.jaxb.PersistentEntityAdapter_ `.class` .
+This rule requires that classes annotated with the JPA _Entity_ annotation 
must also be annotated with the Apache Causeway 
_jakarta.xml.bind.annotation.adapters.XmlJavaTypeAdapter_ annotation with a 
value of _org.apache.causeway.applib.jaxb.PersistentEntityAdapter_ `.class` .
 
 Tnis is so that entities can be transparently referenced from XML-style view 
models.
 
 [#every_jpa_Entity_must_be_annotated_as_an_CausewayEntityListener_]
 === every_jpa_Entity_must_be_annotated_as_an_CausewayEntityListener()
 
-This rule requires that classes annotated with the JPA _Entity_ annotation 
must also be annotated with the _javax.persistence.EntityListeners_ annotation 
that includes a value of 
`org.apache.causeway.persistence.jpa.applib.integration.CausewayEntityListener.class`
 .
+This rule requires that classes annotated with the JPA _Entity_ annotation 
must also be annotated with the _jakarta.persistence.EntityListeners_ 
annotation that includes a value of 
`org.apache.causeway.persistence.jpa.applib.integration.CausewayEntityListener.class`
 .
 
 Tnis is so that entities can be transparently referenced from XML-style view 
models.
 
@@ -130,7 +130,7 @@ This is so that entity tables are organised into an 
appropriate structure (ideal
 [#every_enum_field_of_jpa_Entity_must_be_annotated_with_Enumerable_STRING_]
 === every_enum_field_of_jpa_Entity_must_be_annotated_with_Enumerable_STRING()
 
-This rule requires that enum fields in classes annotated with the JPA _Entity_ 
annotation must also be annotated with the JPA _Enumerated_ annotation 
indicating that they should be persisted as _javax.persistence.EnumType#STRING 
string_ s (rather than ordinal numbers).
+This rule requires that enum fields in classes annotated with the JPA _Entity_ 
annotation must also be annotated with the JPA _Enumerated_ annotation 
indicating that they should be persisted as 
_jakarta.persistence.EnumType#STRING string_ s (rather than ordinal numbers).
 
 The rationale here is that a string is (arguably) more stable than an ordinal 
number, and is certainly easier to work with when querying the database. The 
downside is slightly more space to persist the data, and slightly less 
performant (not that it would be noticeable).
 
@@ -151,7 +151,7 @@ This is part of the standard contract for JPA entities.
 [#every_jpa_Entity_must_have_a_version_field_]
 === every_jpa_Entity_must_have_a_version_field()
 
-This rule requires that classes annotated with the JPA _Entity_ annotation 
must contain a `version` field that is itself annotated with 
_javax.persistence.Version_ .
+This rule requires that classes annotated with the JPA _Entity_ annotation 
must contain a `version` field that is itself annotated with 
_jakarta.persistence.Version_ .
 
 This is good practice for JPA entities to implement optimistic locking
 
diff --git 
a/antora/components/refguide-index/modules/testing/pages/index/unittestsupport/applib/matchers/JaxbMatchers.adoc
 
b/antora/components/refguide-index/modules/testing/pages/index/unittestsupport/applib/matchers/JaxbMatchers.adoc
index 7e00fcf794..881f2cd600 100644
--- 
a/antora/components/refguide-index/modules/testing/pages/index/unittestsupport/applib/matchers/JaxbMatchers.adoc
+++ 
b/antora/components/refguide-index/modules/testing/pages/index/unittestsupport/applib/matchers/JaxbMatchers.adoc
@@ -16,7 +16,7 @@ class JaxbMatchers {
 <.> xref:#isEquivalentTo_T[isEquivalentTo(T)]
 +
 --
-Performs an equality comparison of a 
_javax.xml.bind.annotation.XmlRootElement_ -annotated class to another by 
converting into XML first.
+Performs an equality comparison of a 
_jakarta.xml.bind.annotation.XmlRootElement_ -annotated class to another by 
converting into XML first.
 --
 
 == Members
@@ -24,4 +24,4 @@ Performs an equality comparison of a 
_javax.xml.bind.annotation.XmlRootElement_
 [#isEquivalentTo_T]
 === isEquivalentTo(T)
 
-Performs an equality comparison of a 
_javax.xml.bind.annotation.XmlRootElement_ -annotated class to another by 
converting into XML first.
+Performs an equality comparison of a 
_jakarta.xml.bind.annotation.XmlRootElement_ -annotated class to another by 
converting into XML first.
diff --git 
a/antora/components/refguide-index/modules/viewer/pages/index/commons/applib/services/menu/MenuUiService.adoc
 
b/antora/components/refguide-index/modules/viewer/pages/index/commons/applib/services/menu/MenuUiService.adoc
index eecf72e87f..142292441c 100644
--- 
a/antora/components/refguide-index/modules/viewer/pages/index/commons/applib/services/menu/MenuUiService.adoc
+++ 
b/antora/components/refguide-index/modules/viewer/pages/index/commons/applib/services/menu/MenuUiService.adoc
@@ -7,8 +7,7 @@
 .MenuUiService.java
 ----
 interface MenuUiService {
-  MenuUiModel getMenu(DomainServiceLayout.MenuBar menuBarSelect)
-  void buildMenuItems(MenuUiModel menuUiModel, MenuVisitor menuBuilder)
+  NavbarUiModel getMenu()
 }
 ----
 
diff --git 
a/antora/components/refguide-index/modules/viewer/pages/index/graphql/applib/marshallers/ScalarMarshaller.adoc
 
b/antora/components/refguide-index/modules/viewer/pages/index/graphql/applib/marshallers/ScalarMarshaller.adoc
index e2f30173a5..82250557b3 100644
--- 
a/antora/components/refguide-index/modules/viewer/pages/index/graphql/applib/marshallers/ScalarMarshaller.adoc
+++ 
b/antora/components/refguide-index/modules/viewer/pages/index/graphql/applib/marshallers/ScalarMarshaller.adoc
@@ -3,7 +3,7 @@
 
 Provides an SPI to allow different scalar datatypes to be marshalled to and 
from GraphQL scalar types.
 
-The implementations are called following a chain-of-responsibility pattern, 
first one matching is used. Use _javax.annotation.Priority_ (with 
_org.apache.causeway.applib.annotation.PriorityPrecedence_ values) to override 
the framework-provided defaults, earliest wins.
+The implementations are called following a chain-of-responsibility pattern, 
first one matching is used. Use _jakarta.annotation.Priority_ (with 
_org.apache.causeway.applib.annotation.PriorityPrecedence_ values) to override 
the framework-provided defaults, earliest wins.
 
 == API
 
diff --git 
a/antora/components/refguide-index/modules/viewer/pages/index/restfulobjects/rendering/service/conneg/ContentNegotiationServiceXRoDomainType.adoc
 
b/antora/components/refguide-index/modules/viewer/pages/index/restfulobjects/rendering/service/conneg/ContentNegotiationServiceXRoDomainType.adoc
index 2766015576..632a8fe623 100644
--- 
a/antora/components/refguide-index/modules/viewer/pages/index/restfulobjects/rendering/service/conneg/ContentNegotiationServiceXRoDomainType.adoc
+++ 
b/antora/components/refguide-index/modules/viewer/pages/index/restfulobjects/rendering/service/conneg/ContentNegotiationServiceXRoDomainType.adoc
@@ -5,7 +5,7 @@ Handles content negotiation for accept headers requiring 
`application/json` or `
 
 In the accept header the profile is also checked dependent on the resource 
being invoked; either `profile="urn:org.restfulobjects:repr-types/object"` for 
an object representation, or 
`profile="profile=urn:org.restfulobjects:repr-types/action-result"` for an 
action result.
 
-If the accept header specifies `application/xml` then the service additionally 
verifies that the (mapped) domain object's runtime type is annotated with the 
JAXB _javax.xml.bind.annotation.XmlRootElement_ annotation so that RestEasy is 
able to unambiguously serialize it.
+If the accept header specifies `application/xml` then the service additionally 
verifies that the (mapped) domain object's runtime type is annotated with the 
JAXB _jakarta.xml.bind.annotation.XmlRootElement_ annotation so that RestEasy 
is able to unambiguously serialize it.
 
 == API
 
diff --git a/core/adoc/modules/_overview/pages/about.adoc 
b/core/adoc/modules/_overview/pages/about.adoc
index 352b501230..4649e71d65 100644
--- a/core/adoc/modules/_overview/pages/about.adoc
+++ b/core/adoc/modules/_overview/pages/about.adoc
@@ -516,7 +516,7 @@ o.a.i.testing.h2console.ui.webmodule.WebModuleH2Console +
 .Dependencies
 ****
 com.h2database:h2:jar:<managed> +
-javax.servlet:javax.servlet-api:jar:<managed> +
+jakarta.servlet:jakarta.servlet-api:jar:<managed> +
 org.apache.causeway.core:causeway-core-webapp:jar:<managed> +
 ****
 
@@ -842,17 +842,16 @@ com.approvaltests:approvaltests:jar:<managed> +
 com.fasterxml.jackson.core:jackson-databind:jar:<managed> +
 com.fasterxml.jackson.dataformat:jackson-dataformat-yaml:jar:<managed> +
 com.fasterxml.jackson.datatype:jackson-datatype-jsr310:jar:<managed> +
-com.fasterxml.jackson.module:jackson-module-jaxb-annotations:jar:<managed> +
+com.fasterxml.jackson.jakarta.rs:jackson-jakarta-rs-json-provider:jar:<managed>
 +
+com.fasterxml.jackson.module:jackson-module-jakarta-xmlbind-annotations:jar:<managed>
 +
 com.fasterxml.woodstox:woodstox-core:jar:<managed> +
 com.google.code.gson:gson:jar:<managed> +
 com.sun.xml.bind:jaxb-impl:jar:<managed> +
 jakarta.annotation:jakarta.annotation-api:jar:<managed> +
-jakarta.enterprise:jakarta.enterprise.cdi-api:jar:2.0.2 +
+jakarta.enterprise:jakarta.enterprise.cdi-api:jar:4.0.1 +
 jakarta.inject:jakarta.inject-api:jar:<managed> +
 jakarta.transaction:jakarta.transaction-api:jar:<managed> +
 org.codehaus.woodstox:stax2-api:jar:<managed> +
-org.eclipse.persistence:org.eclipse.persistence.moxy:jar:<managed> +
-org.eclipse.persistence:org.eclipse.persistence.sdo:jar:<managed> +
 org.hamcrest:hamcrest-library:jar:<managed> +
 org.jboss.spec.javax.ws.rs:jboss-jaxrs-api_2.1_spec:jar:<managed> +
 org.jdom:jdom2:jar:<managed> +
@@ -860,7 +859,6 @@ org.jsoup:jsoup:jar:<managed> +
 org.junit.jupiter:junit-jupiter-api:jar:<managed> +
 org.junit.jupiter:junit-jupiter-engine:jar:<managed> +
 org.junit.jupiter:junit-jupiter-params:jar:<managed> +
-org.projectlombok:lombok:jar:<managed> +
 org.slf4j:slf4j-api:jar:<managed> +
 org.springframework:spring-context:jar:<managed> +
 org.springframework:spring-tx:jar:<managed> +
@@ -871,7 +869,7 @@ org.yaml:snakeyaml:jar:<managed> +
 
 .Document Index Entries
 ****
-xref:refguide:commons:index/collections/Can.adoc[Can], 
xref:refguide:commons:index/collections/Cardinality.adoc[Cardinality], 
xref:refguide:commons:index/functional/Either.adoc[Either], 
xref:refguide:commons:index/functional/Railway.adoc[Railway], 
xref:refguide:commons:index/functional/ThrowingConsumer.adoc[ThrowingConsumer], 
xref:refguide:commons:index/functional/ThrowingRunnable.adoc[ThrowingRunnable], 
xref:refguide:commons:index/functional/ThrowingSupplier.adoc[ThrowingSupplier], 
xref [...]
+xref:refguide:commons:index/collections/Can.adoc[Can], 
xref:refguide:commons:index/collections/Cardinality.adoc[Cardinality], 
xref:refguide:commons:index/functional/Either.adoc[Either], 
xref:refguide:commons:index/functional/Railway.adoc[Railway], 
xref:refguide:commons:index/functional/ThrowingRunnable.adoc[ThrowingRunnable], 
xref:refguide:commons:index/functional/Try.adoc[Try], 
xref:refguide:commons:index/io/DataPeer.adoc[DataPeer], 
xref:refguide:commons:index/io/DataSink.adoc[DataSink] [...]
 ****
 |===
 
@@ -1064,6 +1062,7 @@ o.a.i.applib.services.user.UserService +
 ****
 jakarta.persistence:jakarta.persistence-api:jar:<managed> +
 jakarta.validation:jakarta.validation-api:jar:<managed> +
+jakarta.ws.rs:jakarta.ws.rs-api:jar:<managed> +
 joda-time:joda-time:jar:<managed> +
 org.apache.causeway.commons:causeway-commons:jar:<managed> +
 org.apache.causeway.core:causeway-core-internaltestsupport:jar:<managed> +
@@ -1170,6 +1169,7 @@ Directory: /core/internaltestsupport
 
 .Dependencies
 ****
+net.bytebuddy:byte-buddy-agent:jar:<managed> +
 org.apache.causeway.commons:causeway-commons:jar:<managed> +
 org.apache.causeway.core:causeway-core-codegen-bytebuddy:jar:<managed> +
 org.datanucleus:javax.jdo:jar:<managed> +
@@ -1355,11 +1355,11 @@ 
o.a.i.core.runtimeservices.xmlsnapshot.XmlSnapshotServiceDefault +
 
 .Dependencies
 ****
-com.sun.mail:jakarta.mail:jar:<managed> +
 jakarta.mail:jakarta.mail-api:jar:<managed> +
 org.apache.causeway.core:causeway-core-codegen-bytebuddy:jar:<managed> +
 org.apache.causeway.core:causeway-core-internaltestsupport:jar:<managed> +
 org.apache.causeway.core:causeway-core-runtime:jar:<managed> +
+org.eclipse.angus:jakarta.mail:jar:<managed> +
 org.hsqldb:hsqldb:jar:<managed> +
 org.springframework:spring-context-support:jar:<managed> +
 ****
@@ -1448,7 +1448,7 @@ 
o.a.i.core.webapp.webappctx.CausewayWebAppContextInitializer +
 
 .Dependencies
 ****
-javax.servlet:javax.servlet-api:jar:<managed> +
+jakarta.servlet:jakarta.servlet-api:jar:<managed> +
 org.apache.causeway.core:causeway-core-interaction:jar:<managed> +
 org.apache.causeway.core:causeway-core-internaltestsupport:jar:<managed> +
 org.apache.causeway.core:causeway-core-runtime:jar:<managed> +
@@ -1825,7 +1825,7 @@ Credits to the original authors. See also docs [2].
 
 .Dependencies
 ****
-javax.servlet:javax.servlet-api:jar:<managed> +
+jakarta.servlet:jakarta.servlet-api:jar:<managed> +
 org.apache.causeway.commons:causeway-commons:jar:<managed> +
 org.apache.causeway.core:causeway-applib:jar:<managed> +
 org.apache.causeway.core:causeway-core-config:jar:<managed> +
@@ -1937,6 +1937,7 @@ Directory: /persistence/jpa/applib
 org.apache.causeway.commons:causeway-commons:jar:<managed> +
 org.apache.causeway.core:causeway-applib:jar:<managed> +
 org.apache.causeway.core:causeway-core-transaction:jar:<managed> +
+org.eclipse.persistence:org.eclipse.persistence.moxy:jar:4.0.2 +
 org.springframework.data:spring-data-jpa:jar:<managed> +
 ****
 
@@ -1957,10 +1958,11 @@ Directory: /persistence/jpa/eclipselink
 
 .Dependencies
 ****
-jakarta.el:jakarta.el-api:jar:3.0.3 +
+jakarta.el:jakarta.el-api:jar:5.0.1 +
 org.apache.causeway.core:causeway-core-internaltestsupport:jar:<managed> +
 
org.apache.causeway.persistence:causeway-persistence-jpa-integration:jar:<managed>
 +
-org.eclipse.persistence:org.eclipse.persistence.jpa:jar:2.7.14 +
+org.apache.tomcat.embed:tomcat-embed-el:jar:<managed> +
+org.eclipse.persistence:org.eclipse.persistence.jpa:jar:4.0.2 +
 org.springframework.boot:spring-boot-starter-data-jpa:jar:<managed> +
 ****
 
@@ -2287,7 +2289,7 @@ rectangle "Shiro\n<size:10>[Software System]</size>" 
<<Shiro>> {
 Group: org.apache.causeway.security
 Artifact: causeway-security-shiro
 Type: jar
-Directory: /security/shiro
+Directory: /retired/shiro/security/shiro
 ----
 |Authentication and Authorization using Apache Shiro.
 
@@ -2544,7 +2546,7 @@ 
o.a.i.viewer.commons.services.userprof.UserProfileUiServiceDefault +
 
 .Dependencies
 ****
-javax.servlet:javax.servlet-api:jar:<managed> +
+jakarta.servlet:jakarta.servlet-api:jar:<managed> +
 org.apache.causeway.core:causeway-core-internaltestsupport:jar:<managed> +
 org.apache.causeway.viewer:causeway-viewer-commons-model:jar:<managed> +
 ****
@@ -2721,7 +2723,6 @@ 
o.a.i.viewer.graphql.model.types.ScalarMapperUsingScalarMarshallers +
 
 .Dependencies
 ****
-com.graphql-java:graphql-java:jar:<managed> +
 com.graphql-java:graphql-java-extended-scalars:jar:<managed> +
 org.apache.causeway.core:causeway-core-internaltestsupport:jar:<managed> +
 org.apache.causeway.viewer:causeway-viewer-commons-model:jar:<managed> +
@@ -2777,13 +2778,19 @@ Directory: /viewers/graphql/testsupport
 |.Dependencies
 ****
 com.approvaltests:approvaltests:jar:<managed> +
+com.github.gavlyukovskiy:datasource-proxy-spring-boot-starter:jar:<managed> +
+com.github.vertical-blank:sql-formatter:jar:<managed> +
+com.h2database:h2:jar:<managed> +
 org.apache.causeway.core:causeway-core-internaltestsupport:jar:<managed> +
+org.apache.causeway.core:causeway-core-runtimeservices:jar:<managed> +
+org.apache.causeway.persistence:causeway-persistence-jpa-eclipselink:jar:<managed>
 +
 org.apache.causeway.security:causeway-security-bypass:jar:<managed> +
 org.apache.causeway.testing:causeway-testing-fixtures-applib:jar:<managed> +
 
org.apache.causeway.testing:causeway-testing-integtestsupport-applib:jar:<managed>
 +
 org.apache.causeway.viewer:causeway-viewer-graphql-viewer:jar:<managed> +
 org.springframework:spring-context-support:jar:<managed> +
-org.springframework.graphql:spring-graphql-test:jar:${spring-graphql-test.version}
 +
+org.springframework.boot:spring-boot-test-autoconfigure:jar:<managed> +
+org.springframework.graphql:spring-graphql-test:jar:<managed> +
 ****
 
 .Document Index Entries
@@ -2959,6 +2966,9 @@ Directory: /viewers/restfulobjects/client
 ****
 org.apache.causeway.core:causeway-core-internaltestsupport:jar:<managed> +
 org.apache.causeway.viewer:causeway-viewer-restfulobjects-applib:jar:<managed> 
+
+org.eclipse.parsson:parsson:jar:1.1.5 +
+org.eclipse.persistence:org.eclipse.persistence.asm:jar:<managed> +
+org.eclipse.persistence:org.eclipse.persistence.moxy:jar:<managed> +
 org.springframework:spring-context:jar:<managed> +
 ****
 
@@ -2989,8 +2999,12 @@ 
org.apache.causeway.viewer:causeway-viewer-restfulobjects-rendering:jar:<managed
 
org.apache.causeway.viewer:causeway-viewer-restfulobjects-testing:jar:<managed> 
+
 org.apache.causeway.viewer:causeway-viewer-restfulobjects-viewer:jar:<managed> 
+
 org.datanucleus:javax.jdo:jar:<managed> +
+org.jboss.resteasy:resteasy-client:jar:${resteasy.version} +
+org.jboss.resteasy:resteasy-jackson2-provider:jar:${resteasy.version} +
 org.jboss.resteasy:resteasy-jaxb-provider:jar:<managed> +
+org.jboss.resteasy:resteasy-servlet-initializer:jar:${resteasy.version} +
 org.jboss.resteasy:resteasy-spring-boot-starter:jar:<managed> +
+org.jboss.resteasy.spring:resteasy-spring:jar:<managed> +
 ****
 
 .Document Index Entries
@@ -3109,7 +3123,7 @@ 
o.a.i.viewer.restfulobjects.viewer.resources.VersionResourceServerside +
 
 .Dependencies
 ****
-com.fasterxml.jackson.module:jackson-module-jaxb-annotations:jar:<managed> +
+com.fasterxml.jackson.module:jackson-module-jakarta-xmlbind-annotations:jar:<managed>
 +
 org.apache.causeway.core:causeway-core-internaltestsupport:jar:<managed> +
 org.apache.causeway.core:causeway-core-webapp:jar:<managed> +
 org.apache.causeway.viewer:causeway-viewer-commons-services:jar:<managed> +
@@ -3248,8 +3262,10 @@ Directory: /viewers/wicket/model
 |.Dependencies
 ****
 org.apache.causeway.core:causeway-core-webapp:jar:<managed> +
+org.apache.causeway.viewer:causeway-viewer-commons-applib:jar:<managed> +
 org.apache.causeway.viewer:causeway-viewer-commons-model:jar:<managed> +
 org.apache.wicket:wicket-core:jar:<managed> +
+org.apache.wicket:wicket-extensions:jar:<managed> +
 ****
 
 .Document Index Entries
@@ -3293,7 +3309,6 @@ org.webjars:jquery:jar:<managed> +
 org.webjars:jquery-ui:jar:<managed> +
 org.webjars:momentjs:jar:<managed> +
 org.webjars:select2:jar:<managed> +
-org.webjars.npm:summernote:jar:<managed> +
 org.wicketstuff:wicketstuff-select2:jar:<managed> +
 ****
 
@@ -4536,7 +4551,6 @@ Extensions.ApacheCausewayExtpdfjsParent 
.[#707070,thickness=2].> Extensions.Apac
 Extensions.ApacheCausewayExtpdfjsWicket .[#707070,thickness=2].> 
Extensions.ApacheCausewayExtpdfjsWicketIntegration : "<color:#707070>"
 Extensions.ApacheCausewayExtpdfjsWicket .[#707070,thickness=2].> 
Extensions.ApacheCausewayExtpdfjsWicketUI : "<color:#707070>"
 Extensions.ApacheCausewayExtSecMan .[#707070,thickness=2].> 
Extensions.ApacheCausewayExtSecManApplib : "<color:#707070>"
-Extensions.ApacheCausewayExtSecMan .[#707070,thickness=2].> 
Extensions.ApacheCausewayExtSecManDelegatedUsingShiro : "<color:#707070>"
 Extensions.ApacheCausewayExtSecMan .[#707070,thickness=2].> 
Extensions.ApacheCausewayExtSecManDelegatedusingSpringOauth2 : "<color:#707070>"
 Extensions.ApacheCausewayExtSecMan .[#707070,thickness=2].> 
Extensions.ApacheCausewayExtSecManEncryptionUsingjbcrypt : "<color:#707070>"
 Extensions.ApacheCausewayExtSecMan .[#707070,thickness=2].> 
Extensions.ApacheCausewayExtSecManEncryptionUsingSpring : "<color:#707070>"
@@ -4627,7 +4641,6 @@ 
org.apache.causeway.extensions:causeway-extensions-audittrail-applib:test-jar:<m
 
org.apache.causeway.persistence:causeway-persistence-jdo-datanucleus:jar:<managed>
 +
 org.apache.causeway.testing:causeway-testing-fixtures-applib:jar:<managed> +
 
org.apache.causeway.testing:causeway-testing-integtestsupport-applib:jar:<managed>
 +
-org.datanucleus:javax.jdo:jar:${datanucleus-jdo-api.version} +
 ****
 
 |Apache Causeway Ext - Audit Trail Persistence (using JPA)
@@ -4982,14 +4995,14 @@ 
xref:refguide:extensions:index/secman/applib/CausewayModuleExtSecmanApplib.adoc[
 Group: org.apache.causeway.extensions
 Artifact: causeway-extensions-secman-delegated-shiro
 Type: jar
-Directory: /extensions/security/secman/delegated-shiro
+Directory: /retired/shiro/extensions/secman/delegated-shiro
 ----
 |Provides an implementation of a Shiro Realm that will automatically created 
delegated ApplicationUsers for any users externally authenticated in a delegate 
realm
 
 .Dependencies
 ****
 org.apache.causeway.core:causeway-core-runtime:jar:<managed> +
-org.apache.causeway.extensions:causeway-extensions-secman-applib:jar:2.0.0-SNAPSHOT
 +
+org.apache.causeway.extensions:causeway-extensions-secman-applib:jar:3.0.0-SNAPSHOT
 +
 org.apache.causeway.security:causeway-security-shiro:jar:<managed> +
 ****
 
@@ -6544,11 +6557,11 @@ Directory: /tooling
 ----
 |Libraries and tools not depending on the _Apache Causeway Core_ ecosystem,
 eg. code mining, automated documentation.
-(Targeted for JVM 11+)
+(Targeted for JVM 21+)
 
 .Dependencies
 ****
-org.apache.causeway.core:causeway-core-internaltestsupport:jar:${project.version}
 +
+org.apache.causeway.core:causeway-core-internaltestsupport:jar:<managed> +
 org.checkerframework:checker-qual:jar:3.42.0 +
 org.mapstruct:mapstruct-processor:jar:1.5.5.Final +
 org.projectlombok:lombok:jar:<managed> +
@@ -6922,7 +6935,6 @@ 
org.apache.causeway.mavendeps:causeway-mavendeps-webapp:pom:<managed> +
 org.apache.causeway.persistence:causeway-persistence-commons:jar:<managed> +
 
org.apache.causeway.persistence:causeway-persistence-jdo-datanucleus:jar:<managed>
 +
 
org.apache.causeway.persistence:causeway-persistence-jpa-eclipselink:jar:<managed>
 +
-org.apache.causeway.security:causeway-security-shiro:jar:<managed> +
 org.apache.causeway.testing:causeway-testing-fixtures-applib:jar:<managed> +
 
org.apache.causeway.valuetypes:causeway-valuetypes-asciidoc-metamodel:jar:<managed>
 +
 
org.apache.causeway.valuetypes:causeway-valuetypes-markdown-metamodel:jar:<managed>
 +
@@ -6930,6 +6942,7 @@ 
org.apache.causeway.valuetypes:causeway-valuetypes-vega-metamodel:jar:<managed>
 org.apache.causeway.viewer:causeway-viewer-restfulobjects-client:jar:<managed> 
+
 
org.apache.causeway.viewer:causeway-viewer-restfulobjects-jaxrsresteasy:jar:<managed>
 +
 org.apache.causeway.viewer:causeway-viewer-wicket-viewer:jar:<managed> +
+org.apache.wicket:wicket-tester:jar:<managed> +
 ****
 
 |Apache Causeway Regression Tests - Bootstrapping
@@ -7026,7 +7039,7 @@ Directory: /regressiontests/config
 ----
 |.Dependencies
 ****
-com.icegreen:greenmail-junit5:jar:1.6.15 +
+com.icegreen:greenmail-junit5:jar:2.0.1 +
 org.apache.causeway.core:causeway-core-runtimeservices:jar:<managed> +
 
org.apache.causeway.regressiontests:causeway-regressiontests-base:jar:<managed> 
+
 ****
@@ -7261,11 +7274,13 @@ 
org.apache.causeway.viewer:causeway-viewer-wicket-viewer:jar:<managed> +
 
 == Incubator
 
-[plantuml,Incubator,svg]
+=== Kroviz Client
+
+[plantuml,Kroviz Client,svg]
 ----
 @startuml
 set separator none
-title Incubator - Containers
+title Kroviz Client - Containers
 
 left to right direction
 
@@ -7278,43 +7293,41 @@ skinparam {
 
 hide stereotype
 
-skinparam rectangle<<Incubator.ApacheCausewayIncubator>> {
+skinparam rectangle<<KrovizClient.ApacheCausewayIncubatorClientkroViz>> {
   BackgroundColor #438dd5
   FontColor #fffffe
   BorderColor #2e6295
   shadowing false
 }
-skinparam rectangle<<Incubator>> {
+skinparam rectangle<<KrovizClient>> {
   BorderColor #9a9a9a
   FontColor #9a9a9a
   shadowing false
 }
 
-rectangle "Incubator\n<size:10>[Software System]</size>" <<Incubator>> {
-  rectangle "==Apache Causeway Incubator\n<size:10>[Container: packaging: 
pom]</size>" <<Incubator.ApacheCausewayIncubator>> as 
Incubator.ApacheCausewayIncubator
+rectangle "Kroviz Client\n<size:10>[Software System]</size>" <<KrovizClient>> {
+  rectangle "==Apache Causeway Incubator - Client kroViz\n<size:10>[Container: 
packaging: jar]</size>" <<KrovizClient.ApacheCausewayIncubatorClientkroViz>> as 
KrovizClient.ApacheCausewayIncubatorClientkroViz
 }
 
 @enduml
 ----
 
-.Projects/Modules (Incubator)
+.Projects/Modules (Kroviz Client)
 [cols="3a,5a", options="header"]
 |===
 |Coordinates |Description 
 
-|Apache Causeway Incubator
+|Apache Causeway Incubator - Client kroViz
 [source,yaml]
 ----
-Group: org.apache.causeway.incubator
-Artifact: causeway-incubator
-Type: pom
-Directory: /incubator
+Group: org.apache.causeway.incubator.clients
+Artifact: causeway-client-kroviz
+Type: jar
+Directory: /incubator/clients/kroviz
 ----
-|Collection of Apache Causeway artifacts, currently incubating.
+|Web client based on RESTful API
 |===
 
-=== Kroviz Client
-
 === Command Replay
 
 [plantuml,Command Replay,svg]
@@ -7429,7 +7442,7 @@ 
org.apache.causeway.extensions:causeway-extensions-commandlog-applib:jar:<manage
 org.apache.causeway.testing:causeway-testing-fixtures-applib:jar:<managed> +
 org.apache.causeway.viewer:causeway-viewer-restfulobjects-client:jar:<managed> 
+
 
org.apache.causeway.viewer:causeway-viewer-restfulobjects-jaxrsresteasy:jar:<managed>
 +
-org.glassfish.jersey.ext:jersey-spring5:jar:<managed> +
+org.glassfish.jersey.ext:jersey-spring6:jar:<managed> +
 org.springframework.boot:spring-boot-starter-quartz:jar:<managed> +
 ****
 

Reply via email to