You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2020/01/17 07:40:12 UTC

[isis] 06/06: ISIS-2264: sync adoc

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

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

commit eed8e9443231a4bcf91e5e9e4995408fe63098e4
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Fri Jan 17 08:23:04 2020 +0100

    ISIS-2264: sync adoc
---
 .../config/examples/generated/isis.applib.adoc     | 65 ++++++++++++++++------
 .../isis.persistence.jdo-datanucleus.impl.adoc     | 30 +++++-----
 .../examples/generated/isis.security.shiro.adoc    |  3 +-
 .../examples/generated/isis.viewer.wicket.adoc     |  7 ++-
 4 files changed, 68 insertions(+), 37 deletions(-)

diff --git a/core/config/src/main/adoc/modules/config/examples/generated/isis.applib.adoc b/core/config/src/main/adoc/modules/config/examples/generated/isis.applib.adoc
index 37582b5..221706f 100644
--- a/core/config/src/main/adoc/modules/config/examples/generated/isis.applib.adoc
+++ b/core/config/src/main/adoc/modules/config/examples/generated/isis.applib.adoc
@@ -52,21 +52,25 @@ domain-object-layout. +
 css-class-ui-event. +
 post-for-default
 |  true
-| 
+|  Influences whether an {@link org.apache.isis.applib.events.ui.CssClassUiEvent} should be published (on the internal {@link org.apache.isis.applib.services.eventbus.EventBusService}) whenever a domain object is about to be rendered in the UI - thereby allowing subscribers to optionally {@link org.apache.isis.applib.events.ui.CssClassUiEvent#setCssClass(String)} change) the CSS classes that are used.  +
+     The algorithm for determining whether an event is sent depends on the value of the     {@link org.apache.isis.applib.annotation.DomainObjectLayout#cssClassUiEvent()}  @DomainObjectLayout(cssClassEvent=...)} for the     domain object in question.  <ul>     <li>         If set to some subtype of         {@link org.apache.isis.applib.events.ui.CssClassUiEvent.Noop CssClassUiEvent.Noop},         then _no</i> event is sent.     </li>     <li>         If set to some subtype of         {@l [...]
 
 | isis.applib.annotation. +
 domain-object-layout. +
 icon-ui-event. +
 post-for-default
 |  true
-| 
+|  Influences whether an {@link org.apache.isis.applib.events.ui.IconUiEvent} should be published (on the internal {@link org.apache.isis.applib.services.eventbus.EventBusService}) whenever a domain object is about to be rendered in the UI - thereby allowing subscribers to optionally {@link org.apache.isis.applib.events.ui.IconUiEvent#setIconName(String)} change) the icon that is used.  +
+     The algorithm for determining whether an event is sent depends on the value of the     {@link org.apache.isis.applib.annotation.DomainObjectLayout#iconUiEvent()}  @DomainObjectLayout(iconEvent=...)} for the     domain object in question.  <ul>     <li>         If set to some subtype of         {@link org.apache.isis.applib.events.ui.IconUiEvent.Noop IconUiEvent.Noop},         then _no</i> event is sent.     </li>     <li>         If set to some subtype of         {@link org.apache.i [...]
 
 | isis.applib.annotation. +
 domain-object-layout. +
 layout-ui-event. +
 post-for-default
 |  true
-| 
+|  Influences whether an {@link org.apache.isis.applib.events.ui.LayoutUiEvent} should be published (on the internal {@link org.apache.isis.applib.services.eventbus.EventBusService}) whenever a domain object is about to be rendered in the UI - thereby allowing subscribers to optionally {@link org.apache.isis.applib.events.ui.LayoutUiEvent#setLayout(String)} change) the layout that is used.  +
+     If a different layout value has been set, then a layout in the form `Xxx.layout-zzz.xml</code>     use used (where `zzz</code> is the name of the layout).   +
+     The algorithm for determining whether an event is sent depends on the value of the     {@link org.apache.isis.applib.annotation.DomainObjectLayout#layoutUiEvent()}  @DomainObjectLayout(layoutEvent=...)} for the     domain object in question.  <ul>     <li>         If set to some subtype of         {@link org.apache.isis.applib.events.ui.LayoutUiEvent.Noop LayoutUiEvent.Noop},         then _no</i> event is sent.     </li>     <li>         If set to some subtype of         {@link org. [...]
 
 | isis.applib.annotation. +
 domain-object-layout.paged
@@ -78,71 +82,91 @@ domain-object-layout. +
 title-ui-event. +
 post-for-default
 |  true
-| 
+|  Influences whether an {@link org.apache.isis.applib.events.ui.TitleUiEvent} should be published (on the internal {@link org.apache.isis.applib.services.eventbus.EventBusService}) whenever a domain object is about to be rendered in the UI - thereby allowing subscribers to optionally {@link org.apache.isis.applib.events.ui.TitleUiEvent#setTitle(String)} change) the title that is used.  +
+     The algorithm for determining whether an event is sent depends on the value of the     {@link org.apache.isis.applib.annotation.DomainObjectLayout#titleUiEvent()}  @DomainObjectLayout(titleEvent=...)} for the     domain object in question.  <ul>     <li>         If set to some subtype of         {@link org.apache.isis.applib.events.ui.TitleUiEvent.Noop TitleUiEvent.Noop},         then _no</i> event is sent.     </li>     <li>         If set to some subtype of         {@link org.apac [...]
 
 | isis.applib.annotation. +
 domain-object.auditing
 | 
-| 
+|  The default for whether _domain entities</i> should be audited or not (meaning that any changes are sent through to the {@link org.apache.isis.applib.services.audit.AuditerService}.  +
+ This setting can be overridden on a case-by-case basis using {@link DomainObject#getAuditing() DomainObject#getAuditing()}   +
+     Note: this applies only to domain entities, not view models. 
 
 | isis.applib.annotation. +
 domain-object. +
 created-lifecycle-event. +
 post-for-default
 |  true
-| 
+|  Influences whether an {@link org.apache.isis.applib.events.lifecycle.ObjectCreatedEvent} should be published (on the internal {@link org.apache.isis.applib.services.eventbus.EventBusService}) whenever a domain object has been created using {@link org.apache.isis.applib.services.factory.FactoryService}..  +
+     The algorithm for determining whether an event is sent depends on the value of the     {@link org.apache.isis.applib.annotation.DomainObject#createdLifecycleEvent() @DomainObject(createdLifecycleEvent=...)} for the     domain object in question.  <ul>     <li>         If set to some subtype of         {@link org.apache.isis.applib.events.lifecycle.ObjectCreatedEvent.Noop ObjectCreatedEvent.Noop},         then _no</i> event is sent.     </li>     <li>         If set to some subtype o [...]
 
 | isis.applib.annotation. +
 domain-object.editing
 | 
-| 
+|  The default for whether the properties of domain objects can be edited, or whether instead they can be modified only using actions (or programmatically as a side-effect of actions on other objects).  +
+ This setting can be overridden on a case-by-case basis using {@link DomainObject#getEditing()  DomainObject#getEditing()} 
 
 | isis.applib.annotation. +
 domain-object. +
 loaded-lifecycle-event. +
 post-for-default
 |  true
-| 
+|  Influences whether an {@link org.apache.isis.applib.events.lifecycle.ObjectLoadedEvent} should be published (on the internal {@link org.apache.isis.applib.services.eventbus.EventBusService}) whenever a domain _entity</i> has been loaded from the persistence store.  +
+     The algorithm for determining whether an event is sent depends on the value of the     {@link org.apache.isis.applib.annotation.DomainObject#loadedLifecycleEvent() @DomainObject(loadedLifecycleEvent=...)} for the     domain object in question.  <ul>     <li>         If set to some subtype of         {@link org.apache.isis.applib.events.lifecycle.ObjectLoadedEvent.Noop ObjectLoadedEvent.Noop},         then _no</i> event is sent.     </li>     <li>         If set to some subtype of    [...]
+     Note: this applies only to domain entities, not to view models. 
 
 | isis.applib.annotation. +
 domain-object. +
 persisted-lifecycle-event. +
 post-for-default
 |  true
-| 
+|  Influences whether an {@link org.apache.isis.applib.events.lifecycle.ObjectPersistedEvent} should be published (on the internal {@link org.apache.isis.applib.services.eventbus.EventBusService}) whenever a domain _entity</i> has been persisted (for the first time) to the persistence store.  +
+     The algorithm for determining whether an event is sent depends on the value of the     {@link org.apache.isis.applib.annotation.DomainObject#persistedLifecycleEvent() @DomainObject(persistedLifecycleEvent=...)} for the     domain object in question.  <ul>     <li>         If set to some subtype of         {@link org.apache.isis.applib.events.lifecycle.ObjectPersistedEvent.Noop ObjectPersistedEvent.Noop},         then _no</i> event is sent.     </li>     <li>         If set to some s [...]
+     Note: this applies only to domain entities, not to view models. 
 
 | isis.applib.annotation. +
 domain-object. +
 persisting-lifecycle-event. +
 post-for-default
 |  true
-| 
+|  Influences whether an {@link org.apache.isis.applib.events.lifecycle.ObjectPersistingEvent} should be published (on the internal {@link org.apache.isis.applib.services.eventbus.EventBusService}) whenever a domain _entity</i> is about to be persisting (for the first time) to the persistence store.  +
+     The algorithm for determining whether an event is sent depends on the value of the     {@link org.apache.isis.applib.annotation.DomainObject#persistingLifecycleEvent() @DomainObject(persistingLifecycleEvent=...)} for the     domain object in question.  <ul>     <li>         If set to some subtype of         {@link org.apache.isis.applib.events.lifecycle.ObjectPersistingEvent.Noop ObjectPersistingEvent.Noop},         then _no</i> event is sent.     </li>     <li>         If set to so [...]
+     Note: this applies only to domain entities, not to view models. 
 
 | isis.applib.annotation. +
 domain-object.publishing
 | 
-| 
+|  The default for whether the properties of domain objects can be edited, or whether instead changed objects should be sent through to the {@link org.apache.isis.applib.services.publish.PublisherService} for publishing.  +
+     The service's {@link org.apache.isis.applib.services.publish.PublisherService#publish(PublishedObjects) publish}     method is called only once per transaction, with {@link PublishedObjects} collecting details of     all changed domain objects.   +
+  This setting can be overridden on a case-by-case basis using {@link DomainObject#getPublishing() DomainObject#getPublishing()}. 
 
 | isis.applib.annotation. +
 domain-object. +
 removing-lifecycle-event. +
 post-for-default
 |  true
-| 
+|  Influences whether an {@link org.apache.isis.applib.events.lifecycle.ObjectRemovingEvent} should be published (on the internal {@link org.apache.isis.applib.services.eventbus.EventBusService}) whenever a persistent domain _entity</i> is about to be removed (that is, deleted) from the persistence store.  +
+     The algorithm for determining whether an event is sent depends on the value of the     {@link org.apache.isis.applib.annotation.DomainObject#removingLifecycleEvent() @DomainObject(removingLifecycleEvent=...)} for the     domain object in question.  <ul>     <li>         If set to some subtype of         {@link org.apache.isis.applib.events.lifecycle.ObjectRemovingEvent.Noop ObjectRemovingEvent.Noop},         then _no</i> event is sent.     </li>     <li>         If set to some subty [...]
+     Note: this applies only to domain entities, not to view models.   +
+     Note: There is no corresponding `removed</code> callback, because (for the JDO persistence store at least)     it is not possible to interact with a domain entity once it has been deleted. 
 
 | isis.applib.annotation. +
 domain-object. +
 updated-lifecycle-event. +
 post-for-default
 |  true
-| 
+|  Influences whether an {@link org.apache.isis.applib.events.lifecycle.ObjectUpdatedEvent} should be published (on the internal {@link org.apache.isis.applib.services.eventbus.EventBusService}) whenever a persistent domain _entity</i> has been updated in the persistence store.  +
+     The algorithm for determining whether an event is sent depends on the value of the     {@link org.apache.isis.applib.annotation.DomainObject#updatedLifecycleEvent() @DomainObject(updatedLifecycleEvent=...)} for the     domain object in question.  <ul>     <li>         If set to some subtype of         {@link org.apache.isis.applib.events.lifecycle.ObjectUpdatedEvent.Noop ObjectUpdatedEvent.Noop},         then _no</i> event is sent.     </li>     <li>         If set to some subtype o [...]
+     Note: this applies only to domain entities, not to view models. 
 
 | isis.applib.annotation. +
 domain-object. +
 updating-lifecycle-event. +
 post-for-default
 |  true
-| 
+|  Influences whether an {@link org.apache.isis.applib.events.lifecycle.ObjectUpdatingEvent} should be published (on the internal {@link org.apache.isis.applib.services.eventbus.EventBusService}) whenever a persistent domain _entity</i> is about to be updated in the persistence store.  +
+     The algorithm for determining whether an event is sent depends on the value of the     {@link org.apache.isis.applib.annotation.DomainObject#updatingLifecycleEvent() @DomainObject(updatingLifecycleEvent=...)} for the     domain object in question.  <ul>     <li>         If set to some subtype of         {@link org.apache.isis.applib.events.lifecycle.ObjectUpdatingEvent.Noop ObjectUpdatingEvent.Noop},         then _no</i> event is sent.     </li>     <li>         If set to some subty [...]
+     Note: this applies only to domain entities, not to view models. 
 
 | isis.applib.annotation. +
 parameter-layout. +
@@ -177,28 +201,33 @@ view-model-layout. +
 css-class-ui-event. +
 post-for-default
 |  true
-| 
+|  Influences whether an {@link org.apache.isis.applib.events.ui.CssClassUiEvent} should be published (on the internal {@link org.apache.isis.applib.services.eventbus.EventBusService}) whenever a view model (annotated with {@link org.apache.isis.applib.annotation.ViewModel @ViewModel}) is about to be rendered in the UI - thereby allowing subscribers to optionally {@link org.apache.isis.applib.events.ui.CssClassUiEvent#setCssClass(String)} change) the CSS classes that are used.  +
+     The algorithm for determining whether an event is sent depends on the value of the     {@link org.apache.isis.applib.annotation.ViewModelLayout#cssClassUiEvent()}  @ViewModelLayout(cssClassEvent=...)} for the     domain object in question.  <ul>     <li>         If set to some subtype of         {@link org.apache.isis.applib.events.ui.CssClassUiEvent.Noop CssClassUiEvent.Noop},         then _no</i> event is sent.     </li>     <li>         If set to some subtype of         {@link or [...]
 
 | isis.applib.annotation. +
 view-model-layout. +
 icon-ui-event. +
 post-for-default
 |  true
-| 
+|  Influences whether an {@link org.apache.isis.applib.events.ui.IconUiEvent} should be published (on the internal {@link org.apache.isis.applib.services.eventbus.EventBusService}) whenever a view model (annotated with {@link org.apache.isis.applib.annotation.ViewModel @ViewModel}) is about to be rendered in the UI - thereby allowing subscribers to optionally {@link org.apache.isis.applib.events.ui.IconUiEvent#setIconName(String)} change) the icon that is used.  +
+     The algorithm for determining whether an event is sent depends on the value of the     {@link org.apache.isis.applib.annotation.ViewModelLayout#iconUiEvent()}  @ViewModelLayout(iconEvent=...)} for the     domain object in question.  <ul>     <li>         If set to some subtype of         {@link org.apache.isis.applib.events.ui.IconUiEvent.Noop IconUiEvent.Noop},         then _no</i> event is sent.     </li>     <li>         If set to some subtype of         {@link org.apache.isis.ap [...]
 
 | isis.applib.annotation. +
 view-model-layout. +
 layout-ui-event. +
 post-for-default
 |  true
-| 
+|  Influences whether an {@link org.apache.isis.applib.events.ui.LayoutUiEvent} should be published (on the internal {@link org.apache.isis.applib.services.eventbus.EventBusService}) whenever a view model (annotated with {@link org.apache.isis.applib.annotation.ViewModel @ViewModel}) is about to be rendered in the UI - thereby allowing subscribers to optionally {@link org.apache.isis.applib.events.ui.LayoutUiEvent#setLayout(String)} change) the layout that is used.  +
+     If a different layout value has been set, then a layout in the form `Xxx.layout-zzz.xml</code>     use used (where `zzz</code> is the name of the layout).   +
+     The algorithm for determining whether an event is sent depends on the value of the     {@link org.apache.isis.applib.annotation.ViewModelLayout#layoutUiEvent()}  @ViewModelLayout(layoutEvent=...)} for the     domain object in question.  <ul>     <li>         If set to some subtype of         {@link org.apache.isis.applib.events.ui.LayoutUiEvent.Noop LayoutUiEvent.Noop},         then _no</i> event is sent.     </li>     <li>         If set to some subtype of         {@link org.apache [...]
 
 | isis.applib.annotation. +
 view-model-layout. +
 title-ui-event. +
 post-for-default
 |  true
-| 
+|  Influences whether an {@link org.apache.isis.applib.events.ui.TitleUiEvent} should be published (on the internal {@link org.apache.isis.applib.services.eventbus.EventBusService}) whenever a view model (annotated with {@link org.apache.isis.applib.annotation.ViewModel @ViewModel}) is about to be rendered in the UI - thereby allowing subscribers to optionally {@link org.apache.isis.applib.events.ui.TitleUiEvent#setTitle(String)} change) the title that is used.  +
+     The algorithm for determining whether an event is sent depends on the value of the     {@link org.apache.isis.applib.annotation.ViewModelLayout#titleUiEvent()}  @ViewModelLayout(titleEvent=...)} for the     domain object in question.  <ul>     <li>         If set to some subtype of         {@link org.apache.isis.applib.events.ui.TitleUiEvent.Noop TitleUiEvent.Noop},         then _no</i> event is sent.     </li>     <li>         If set to some subtype of         {@link org.apache.isi [...]
 
 | isis.applib.annotation. +
 view-model.validation. +
diff --git a/core/config/src/main/adoc/modules/config/examples/generated/isis.persistence.jdo-datanucleus.impl.adoc b/core/config/src/main/adoc/modules/config/examples/generated/isis.persistence.jdo-datanucleus.impl.adoc
index e28fe3a..6a29259 100644
--- a/core/config/src/main/adoc/modules/config/examples/generated/isis.persistence.jdo-datanucleus.impl.adoc
+++ b/core/config/src/main/adoc/modules/config/examples/generated/isis.persistence.jdo-datanucleus.impl.adoc
@@ -47,7 +47,7 @@ connection-factory-name
 | 
 |  The JNDI name for a connection factory for transactional connections. 	 +
  	    For RBDMS, it must be a JNDI name that points to a javax.sql.DataSource object. 	  +
-     See also `additional-spring-configuration-metadata.json</tt> (change casing).  @implNote - this config property isn't used by the framework, but is provided as a convenience for IDE autocomplete.
+     See also `additional-spring-configuration-metadata.json</tt> (PascalCasing instead of kebab-casing).  @implNote - this config property isn't used by the framework, but is provided as a convenience for IDE autocomplete.
 
 | isis.persistence. +
 jdo-datanucleus.impl. +
@@ -56,7 +56,7 @@ connection-factory2-name
 | 
 |  The JNDI name for a connection factory for non-transactional connections. 	 +
  	    For RBDMS, it must be a JNDI name that points to a javax.sql.DataSource object. 	  +
-     See also `additional-spring-configuration-metadata.json</tt> (change casing).  @implNote - this config property isn't used by the framework, but is provided as a convenience for IDE autocomplete.
+     See also `additional-spring-configuration-metadata.json</tt> (PascalCasing instead of kebab-casing).  @implNote - this config property isn't used by the framework, but is provided as a convenience for IDE autocomplete.
 
 | isis.persistence. +
 jdo-datanucleus.impl. +
@@ -64,7 +64,7 @@ datanucleus. +
 connection-password-decrypter
 | 
 |  Name of a class that implements `org.datanucleus.store.connection.DecryptionProvider</tt> and should only be specified if the password is encrypted in the persistence properties.  +
-     See also `additional-spring-configuration-metadata.json</tt> (change casing).  @implNote - this config property isn't used by the framework, but is provided as a convenience for IDE autocomplete.
+     See also `additional-spring-configuration-metadata.json</tt> (camelCasing instead of kebab-casing).  @implNote - this config property isn't used by the framework, but is provided as a convenience for IDE autocomplete.
 
 | isis.persistence. +
 jdo-datanucleus.impl. +
@@ -79,8 +79,8 @@ class-name
 |  org.apache.isis.persistence. +
 jdo.datanucleus5.datanucleus. +
 JDOStateManagerForIsis
-|  New feature in DN 3.2.3; enables dependency injection into entities  +
-     See also `additional-spring-configuration-metadata.json</tt> (change casing). 
+|  Enables dependency injection into entities  +
+     See also `additional-spring-configuration-metadata.json</tt> (camelCasing instead of kebab-casing). 
 
 | isis.persistence. +
 jdo-datanucleus.impl. +
@@ -96,7 +96,7 @@ persistence-unit-load-classes
 |  true
 |  Used when we have specified the persistence-unit name for a PMF/EMF and where we want the 	datastore "tables" for all classes of that persistence-unit loading up into the StoreManager.  +
      Defaults to true, which is the opposite of DataNucleus' own default.     (The reason that DN defaults to false is because some databases are slow so such an     operation would slow down the startup process).   +
-     See also `additional-spring-configuration-metadata.json</tt> (change casing).  @implNote - this config property isn't used by the framework, but is provided as a convenience for IDE autocomplete.
+     See also `additional-spring-configuration-metadata.json</tt> (camelCasing instead of kebab-casing).  @implNote - this config property isn't used by the framework, but is provided as a convenience for IDE autocomplete.
 
 | isis.persistence. +
 jdo-datanucleus.impl. +
@@ -113,7 +113,7 @@ auto-create-all
 | 
 |  Whether DN should automatically create the database schema on bootstrapping.  +
      This should be set to `true</tt> when running against an in-memory database, but     set to `false</tt> when running against a persistent database (use something like     flyway instead to manage schema evolution).   +
-     See also `additional-spring-configuration-metadata.json</tt> (change casing).  @implNote - this config property isn't used by the core framework, but is used by one the flyway extension.
+     See also `additional-spring-configuration-metadata.json</tt> (camelCasing instead of kebab-casing).  @implNote - this config property isn't used by the core framework, but is used by one the flyway extension.
 
 | isis.persistence. +
 jdo-datanucleus.impl. +
@@ -121,7 +121,7 @@ datanucleus.schema. +
 auto-create-database
 | 
 |  Previously we defaulted this property to "true", but that could cause the target database to be modified  +
-     See also `additional-spring-configuration-metadata.json</tt> (change casing).  @implNote - this config property isn't used by the framework, but is provided as a convenience for IDE autocomplete.
+     See also `additional-spring-configuration-metadata.json</tt> (camelCasing instead of kebab-casing).  @implNote - this config property isn't used by the framework, but is provided as a convenience for IDE autocomplete.
 
 | isis.persistence. +
 jdo-datanucleus.impl. +
@@ -143,7 +143,7 @@ datanucleus.schema. +
 validate-all
 |  true
 |   +
-     See also `additional-spring-configuration-metadata.json</tt> (change casing).  @implNote - this config property isn't used by the framework, but is provided as a convenience for IDE autocomplete.
+     See also `additional-spring-configuration-metadata.json</tt> (camelCasing instead of kebab-casing).  @implNote - this config property isn't used by the framework, but is provided as a convenience for IDE autocomplete.
 
 | isis.persistence. +
 jdo-datanucleus.impl. +
@@ -172,7 +172,7 @@ datanucleus.transaction-type
 | 
 |  Type of transaction to use.  +
  If running under JavaSE the default is RESOURCE_LOCAL, and if running under JavaEE the default is JTA.   +
-     See also `additional-spring-configuration-metadata.json</tt> (change casing).  @implNote - this config property isn't used by the framework, but is provided as a convenience for IDE autocomplete.
+     See also `additional-spring-configuration-metadata.json</tt> (camelCasing instead of kebab-casing).  @implNote - this config property isn't used by the framework, but is provided as a convenience for IDE autocomplete.
 
 | isis.persistence. +
 jdo-datanucleus.impl.javax. +
@@ -213,7 +213,7 @@ jdo.option. +
 connection-driver-name
 | 
 |  JDBC driver used by DataNucleus Object store to connect.  +
-     See also `additional-spring-configuration-metadata.json</tt> (change casing).  @implNote - this config property isn't used by the framework, but provided as a convenience for IDE autocomplete (and is mandatory if using JDO Datanucleus).
+     See also `additional-spring-configuration-metadata.json</tt> (PascalCasing instead of kebab-casing).  @implNote - this config property isn't used by the framework, but provided as a convenience for IDE autocomplete (and is mandatory if using JDO Datanucleus).
 
 | isis.persistence. +
 jdo-datanucleus.impl.javax. +
@@ -221,14 +221,14 @@ jdo.option. +
 connection-password
 | 
 |  Password for the user account used by DataNucleus Object store to connect.  +
-     See also `additional-spring-configuration-metadata.json</tt> (change casing).  @implNote - this config property isn't used by the framework, but provided as a convenience for IDE autocomplete.  It is not necessarily mandatory, some databases accept an empty password.
+     See also `additional-spring-configuration-metadata.json</tt> (PascalCasing instead of kebab-casing).  @implNote - this config property isn't used by the framework, but provided as a convenience for IDE autocomplete.  It is not necessarily mandatory, some databases accept an empty password.
 
 | isis.persistence. +
 jdo-datanucleus.impl.javax. +
 jdo.option.connection-url
 | 
 |  URL used by DataNucleus Object store to connect.  +
-     See also `additional-spring-configuration-metadata.json</tt> (change casing).  @implNote - some extensions (H2Console, MsqlDbManager) peek at this URL to determine if they should be enabled.  Note that it is also mandatory if using JDO Datanucleus.
+     See also `additional-spring-configuration-metadata.json</tt> (PascalCasing instead of kebab-casing).  @implNote - some extensions (H2Console, MsqlDbManager) peek at this URL to determine if they should be enabled.  Note that it is also mandatory if using JDO Datanucleus.
 
 | isis.persistence. +
 jdo-datanucleus.impl.javax. +
@@ -236,7 +236,7 @@ jdo.option. +
 connection-user-name
 | 
 |  User account used by DataNucleus Object store to connect.  +
-     See also `additional-spring-configuration-metadata.json</tt> (change casing).  @implNote - this config property isn't used by the framework, but provided as a convenience for IDE autocomplete (and is mandatory if using JDO Datanucleus).
+     See also `additional-spring-configuration-metadata.json</tt> (PascalCasing instead of kebab-casing).  @implNote - this config property isn't used by the framework, but provided as a convenience for IDE autocomplete (and is mandatory if using JDO Datanucleus).
 
 | isis.persistence. +
 jdo-datanucleus.impl.javax. +
@@ -246,5 +246,5 @@ class
 |  org.datanucleus.api.jdo. +
 JDOPersistenceManagerFactory
 |   +
-     See also `additional-spring-configuration-metadata.json</tt> (change casing).  @implNote - changing this property from its default is used to enable the flyway extension (in combination with {@link Datanucleus.Schema#isAutoCreateAll()}
+     See also `additional-spring-configuration-metadata.json</tt> (camelCasing instead of kebab-casing).  @implNote - changing this property from its default is used to enable the flyway extension (in combination with {@link Datanucleus.Schema#isAutoCreateAll()}
 
diff --git a/core/config/src/main/adoc/modules/config/examples/generated/isis.security.shiro.adoc b/core/config/src/main/adoc/modules/config/examples/generated/isis.security.shiro.adoc
index 9067e26..99618ff 100644
--- a/core/config/src/main/adoc/modules/config/examples/generated/isis.security.shiro.adoc
+++ b/core/config/src/main/adoc/modules/config/examples/generated/isis.security.shiro.adoc
@@ -2,5 +2,6 @@
 auto-logout-if-already- +
 authenticated
 | 
-| 
+|  If the Shiro subject is found to be still authenticated, then will be logged out anyway and then re-authenticated.  +
+ Applies only to the Restful Objects viewer. 
 
diff --git a/core/config/src/main/adoc/modules/config/examples/generated/isis.viewer.wicket.adoc b/core/config/src/main/adoc/modules/config/examples/generated/isis.viewer.wicket.adoc
index 8c0b5a9..049224c 100644
--- a/core/config/src/main/adoc/modules/config/examples/generated/isis.viewer.wicket.adoc
+++ b/core/config/src/main/adoc/modules/config/examples/generated/isis.viewer.wicket.adoc
@@ -12,12 +12,13 @@ IsisWicketApplication
 | isis.viewer.wicket. +
 application.about
 | 
-|  Label used on the about page. If not specified, then {@link Application#name}  is used instead.
+|  Label used on the about page.
 
 | isis.viewer.wicket. +
 application.brand-logo-header
 | 
-|  Either the location of the image file (relative to the class-path resource root),  or an absolute URL. This is rendered on the header panel. An image with a size of 160x40 works well. If not specified, the application.name is used instead.
+|  Either the location of the image file (relative to the class-path resource root),  or an absolute URL.  +
+ This is rendered on the header panel. An image with a size of 160x40 works well. If not specified, the application.name is used instead. 
 
 | isis.viewer.wicket. +
 application.brand-logo-signin
@@ -54,7 +55,7 @@ menubars-layout-xml
 | isis.viewer.wicket. +
 application.name
 |  Apache Isis ™
-|  Identifies the application on the sign-in page (unless a {@link Application#brandLogoSignin} image is configured) and  on top-left in the header  (unless a {@link Application#brandLogoHeader} image is configured).
+|  Identifies the application on the sign-in page (unless a {@link Application#brandLogoSignin} image is configured) and on top-left in the header (unless a {@link Application#brandLogoHeader} image is configured).
 
 | isis.viewer.wicket. +
 application.version