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 2016/07/12 22:54:06 UTC
[13/21] isis git commit: ISIS-1335: updates docs,
removing references to 1.13.0-SNAPSHOT
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_CommandContext.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_CommandContext.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_CommandContext.adoc
index 7e7393f..9516c7a 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_CommandContext.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_CommandContext.adoc
@@ -11,7 +11,7 @@ The `CommandContext` service is a xref:rgant.adoc#_rgant-RequestScoped[request-s
By default, the `Command` is held in-memory only; once the action invocation has completed, the `Command` object is gone. The optional
supporting xref:rgsvc.adoc#_rgsvc_spi_CommandService[`CommandService`] enables the implementation of `Command` to be pluggable. With an appropriate implementation (eg as provided by the (non-ASF) http://github.com/isisaddons/isis-module-command[Isis addons' command] module's xref:rgsvc.adoc#_rgsvc_spi_CommandService[`CommandService`]) the `Command` may then be persisted.
-As of `1.13.0-SNAPSHOT`, the primary use case for persistent ``Command``s is in support of background commands; they
+As of `1.13.0`, the primary use case for persistent ``Command``s is in support of background commands; they
act as a parent to any background commands that can be persisted either explicitly using the
xref:rgsvc.adoc#_rgsvc_api_BackgroundService[`BackgroundService`], or implicitly by way of the
xref:rgant.adoc#_rgant-Action_command[`@Action#command()`] annotation.
@@ -19,17 +19,11 @@ xref:rgant.adoc#_rgant-Action_command[`@Action#command()`] annotation.
In previous versions of the framework, persistent ``Command``s also supported a number of other use cases:
* they enable profiling of the running application (which actions are invoked then most often, what is their response time)
-* if xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`PublishingService`] or
-xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`] (`1.13.0-SNAPSHOT`) is configured, they provide better traceability
-as the `Command` is also correlated with any published events, again through the unique `transactionId` GUID
-* if xref:rgsvc.adoc#_rgsvc_spi_AuditService[`AuditingService`] or
- xref:rgsvc.adoc#_rgsvc_spi_AuderService[`AuditerService`] (`1.13.0-SNAPSHOT`) is configured, they provide better audit
- information, since the `Command` (the 'cause' of an action) can be correlated to the audit records (the "effect" of
- the action) through the `transactionId` GUID
-
-As of `1.13.0-SNAPSHOT`, these other uses cases are now more fully supported through the
-xref:rgsvc.adoc#_rgsvc_api_InteractionContext[`InteractionContext`] service and persistent implementations of the
-``Interaction`` object, eg as provided by the (non-ASF)
+* if a xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`] or xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`PublishingService`] (the latter now deprecated) is configured, they provide better traceability as the `Command` is also correlated with any published events, again through the unique `transactionId` GUID
+* if a xref:rgsvc.adoc#_rgsvc_spi_AuderService[`AuditerService`] or xref:rgsvc.adoc#_rgsvc_spi_AuditService[`AuditingService`] (the latter now deprecated) is configured, they provide better audit information, since the `Command` (the 'cause' of an action) can be correlated to the audit records (the "effect" of the action) through the `transactionId` GUID
+
+As of `1.13.0`, these other uses cases are now more fully supported through the
+xref:rgsvc.adoc#_rgsvc_api_InteractionContext[`InteractionContext`] service and persistent implementations of the ``Interaction`` object, eg as provided by the (non-ASF)
http://github.com/isisaddons/isis-module-publishmq[Isis addons' publishmq] module.
@@ -114,7 +108,7 @@ public interface Command extends HasTransactionId {
<15> `getParent()` - for actions created through the `BackgroundService`, captures the parent action
<16> `getResult()` - bookmark to object returned by action, if any
<17> `getException()` - exception stack trace if action threw exception
-<18> (as of `1.13.0-SNAPSHOT`) no longer used by the framework; see instead
+<18> No longer used by the framework; see instead
xref:rgsvc.adoc#_rgsvc_api_InteractionContext[`InteractionContext`] and `Interaction#next()`.
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_InteractionContext.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_InteractionContext.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_InteractionContext.adoc
index aacfa13..7cd7864 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_InteractionContext.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_InteractionContext.adoc
@@ -1,12 +1,12 @@
[[_rgsvc_api_InteractionContext]]
-= `InteractionContext` (`1.13.0-SNAPSHOT`)
+= `InteractionContext`
: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 agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
:_basedir: ../
:_imagesdir: images/
-The `InteractionContext` (`1.13.0-SNAPSHOT`) is a request-scoped domain service that is used to obtain the current
+The `InteractionContext` is a request-scoped domain service that is used to obtain the current
`Interaction`.
An `Interaction` generally consists of a single top-level `Execution`, either to invoke an action or to edit a
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_MementoService.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_MementoService.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_MementoService.adoc
index 4a2de0c..82731e9 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_MementoService.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_MementoService.adoc
@@ -10,13 +10,14 @@ The `MementoService` was originally introduced to simplify the implementation of
xref:ugbtb.adoc#_ugbtb_view-models[ViewModel]s which are required by the framework to return string representation of
all of their backing state, moreover which is safe for use within a URL.
-However, it can also be used to create a memento of arbitrary objects. (Prior to `1.13.0-SNAPSHOT) it is used
+However, it can also be used to create a memento of arbitrary objects. (Prior to `1.13.0` it wass used
internally by the core implementation of xref:rgsvc.adoc#_rgsvc_api_BackgroundService[`BackgroundService`] to capture
-the state of action invocations so that they can be executed by a background process.
+the state of action invocations so that they can be executed by a background process; this is now done using xref:rgfis.adoc#_rgfis_spi_CommandDtoServiceInternal[`CommandDtoServiceInternal`]
+
[NOTE]
====
-As of `1.13.0-SNAPSHOT` this service is deprecated.
+As of `1.13.0` this service is deprecated.
====
@@ -122,10 +123,8 @@ public class ExternalEntity implements ViewModel {
== Related Services
-(Prior to `1.13.0-SNAPSHOT`), the memento service is used by the
-xref:rgsvc.adoc#_rgsvc_api_CommandContext[`CommandContext`] service and also
-xref:rgsvc.adoc#_rgsvc_spi_BackgroundCommandService[`BackgroundCommandService`]. These both use a memento to capture a
-representation of an action invocation.
+(Prior to `1.13.0`), the memento service was used by the xref:rgsvc.adoc#_rgsvc_api_CommandContext[`CommandContext`] service and also
+xref:rgsvc.adoc#_rgsvc_spi_BackgroundCommandService[`BackgroundCommandService`]. These both use a memento to capture a representation of an action invocation. This is now done using xref:rgfis.adoc#_rgfis_spi_CommandDtoServiceInternal[`CommandDtoServiceInternal`].
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_MetamodelService.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_MetamodelService.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_MetamodelService.adoc
index 801a720..e32907c 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_MetamodelService.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_MetamodelService.adoc
@@ -6,8 +6,7 @@
-The `MetaModelService2` (`MetaModelService2` sub-interface introduced in `1.13.0-SNAPSHOT`) provides access to
-a number of aspects of Apache Isis' internal metamodel.
+The `MetaModelService2` service provides access to a number of aspects of Apache Isis' internal metamodel.
== API
@@ -35,7 +34,7 @@ public interface MetaModelService2 {
<2> lookup of a domain class' object type
<3> invalidate and rebuild the internal metadata (an `ObjectSpecification`) for the specified domain type.
<4> returns a list of representations of each of member of each domain class.
-<5> (`1.13.0-SNAPSHOT`) what sort of object a domain type is (or bookmark represents)
+<5> what sort of object a domain type is (or bookmark) represents
== Implementation
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_MetricsService.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_MetricsService.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_MetricsService.adoc
index d71a7de..a7237f6 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_MetricsService.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_MetricsService.adoc
@@ -1,12 +1,12 @@
[[_rgsvc_api_MetricsService]]
-= `MetricsService` (`1.13.0-SNAPSHOT`)
+= `MetricsService`
: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 agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
:_basedir: ../
:_imagesdir: images/
-The `MetricsService` (`1.13.0-SNAPSHOT`) is a request-scoped domain service that hooks into the JDO/DataNucleus
+The `MetricsService` is a request-scoped domain service that hooks into the JDO/DataNucleus
ObjectStore to provide a number of counters relating to numbers of object loaded, dirtied etc.
The service is used by the xref:rgsvc.adoc#_rgsvc_api_InteractionContext[`InteractionContext`] domain service (to populate the DTO held by the `Interaction.Execution`) and also by the (internal) xref:rgfis.adoc#_rgfis_spi_PublishingServiceInternal[`PublishingServiceInternal`] domain service (to populate
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_RepositoryService.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_RepositoryService.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_RepositoryService.adoc
index 5aafe76..437c1c0 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_RepositoryService.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_RepositoryService.adoc
@@ -51,9 +51,9 @@ xref:rgsvc.adoc#_rgsvc_api_FactoryService[`FactoryService`]'s `instantiate(...)`
``RepositoryService``'s API too because instantiating and persisting objects are often done together.
<2> test whether a particular domain object is persistent or not
<3> persist (ie save) an object to the persistent object store (or do nothing if it is already persistent).
-<4> (`1.13.0-SNAPSHOT`) persist (ie save) and flush; same as `persist()`, but also flushes changes to database and updates managed properties and collections (i.e., 1-1, 1-n, m-n relationships automatically maintained by the DataNucleus persistence mechanism).
+<4> persist (ie save) and flush; same as `persist()`, but also flushes changes to database and updates managed properties and collections (i.e., 1-1, 1-n, m-n relationships automatically maintained by the DataNucleus persistence mechanism).
<5> remove (ie delete) an object from the persistent object store (or do nothing if it has already been deleted).
-<6> (`1.13.0-SNAPSHOT`) remove (delete) and flush; same as `remove()`, but also flushes changes to database and updates managed properties and collections (i.e., 1-1, 1-n, m-n relationships automatically maintained by the DataNucleus persistence mechanism).
+<6> remove (delete) and flush; same as `remove()`, but also flushes changes to database and updates managed properties and collections (i.e., 1-1, 1-n, m-n relationships automatically maintained by the DataNucleus persistence mechanism).
<7> return all persisted instances of specified type. Mostly for prototyping, though can be useful to obtain all instances of domain entities if the number is known to be small. The optional varargs parameters are for paging control; more on this below.
<8> all persistence instances matching the specified `Query`. Query itself is an Isis abstraction on top of JDO/DataNucleus' Query API. *This is the primary API used for querying*
<9> As the previous, but with client-side filtering using a `Predicate`. Only really intended for prototyping.
@@ -93,8 +93,8 @@ In some cases, such as when using managed properties and collections for impleme
the developer needs to invoke `flush()` to send the changes to the DataNucleus persistence mechanism. These
managed properties and collections and then updated.
-The `persistAndFlush(...)` and `removeAndFlush(...)` methods (introduced in `1.13.0-SNAPSHOT`) save the developer from
-having to call the `flush(...)` method.
+The `persistAndFlush(...)` and `removeAndFlush(...)` methods save the developer from
+having to additionally call the `flush(...)` method after calling `persist()` or `remove()`.
For example, the following code requires a flush to occur, so uses these methods:
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_ServiceRegistry.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_ServiceRegistry.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_ServiceRegistry.adoc
index a3c2928..e7ccf5c 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_ServiceRegistry.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_ServiceRegistry.adoc
@@ -5,7 +5,7 @@
:_imagesdir: images/
-The `ServiceRegistry2` service collects together methods for accessing other domain services. (The `ServiceRegistry2` extension to the original `ServiceRegistry` API has been introduced in `1.13.0-SNAPSHOT`).
+The `ServiceRegistry2` service collects together methods for accessing other domain services.
[NOTE]
====
@@ -15,7 +15,7 @@ The methods in this service replace similar methods (now deprecated) in xref:rgs
== API
-The API of `ServiceRegistry` is:
+The API of `ServiceRegistry2` is:
[source,java]
----
@@ -29,7 +29,7 @@ public interface ServiceRegistry2 {
<1> injects services into domain object; used extensively internally by the framework (eg to inject to other services, or to entities, or integration test instances, or fixture scripts).
<2> returns the first registered service that implements the specified class
<3> returns an `Iterable` in order to iterate over all registered services that implement the specified class
-<4> (`1.13.0-SNAPSHOT`) returns the list of all domain services that constitute the running application (including internal domain services).
+<4> returns the list of all domain services that constitute the running application (including internal domain services).
Service injection is done automatically if objects are created using the
xref:rgsvc.adoc#_rgsvc_api_FactoryService[`FactoryService`].
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgsvc_application-layer-api.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_application-layer-api.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_application-layer-api.adoc
index 66bc8a4..c33b7fc 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_application-layer-api.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_application-layer-api.adoc
@@ -70,7 +70,7 @@ The xref:rgsvc.adoc#_rgsvc_api_InteractionContext[`InteractionContext`] manages
|xref:rgsvc.adoc#_rgsvc_api_InteractionContext[`o.a.i.applib.` +
`services.iactn` +
`InteractionContext`]
-|(`1.13.0-SNAPSHOT`) Request-scoped access to the current member execution (action invocation or property edit),
+|Request-scoped access to the current member execution (action invocation or property edit),
represented as the `Interaction` context.
|`InteractionContext` +
``o.a.i.core`` +
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgsvc_intro.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_intro.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_intro.adoc
index eaeb054..eda53ac 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_intro.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_intro.adoc
@@ -160,7 +160,7 @@ The above code could be improved by caching the delegateLocaleProvider once loca
[[_rgsvc_intro_commands-and-events]]
-== Command and Events (`1.13.0-SNAPSHOT`)
+== Command and Events
A good number of the domain services manage the execution of action invocations/property edits, along with the state
of domain objects that are modified as a result of these. These services capture information which can then be used
@@ -226,8 +226,8 @@ xref:rgsvc.adoc#_rgsvc_api_TransactionService[`TransactionService`].
====
* Also at the end of each transaction, details of all changed properties are passed to any registered
-xref:rgsvc.adoc#_rgsvc_spi_AuditingService[`AuditingService`] or
-xref:rgsvc.adoc#_rgsvc_spi_AuditerService[`AuditerService`] (`1.13.0-SNAPSHOT`) by way of the (internal)
+xref:rgsvc.adoc#_rgsvc_spi_AuditerService[`AuditerService`] or
+xref:rgsvc.adoc#_rgsvc_spi_AuditingService[`AuditingService`] (the latter deprecated) by way of the (internal)
xref:rgfis.adoc#_rgfis_spi_AuditingServiceInternal[`AuditingServiceInternal`] domain service.
Implementations of xref:rgsvc.adoc#_rgsvc_spi_CommandService[`CommandService`] can use the `Command#getMemento()`
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgsvc_persistence-layer-spi.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_persistence-layer-spi.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_persistence-layer-spi.adoc
index 798bdb5..f636344 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_persistence-layer-spi.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_persistence-layer-spi.adoc
@@ -26,7 +26,7 @@ The table below summarizes the persistence layer SPIs defined by Apache Isis. I
|xref:rgsvc.adoc#_rgsvc_spi_AuditingService[`o.a.i.applib.` +
`services.audit` +
`AuditerService`]
-|(`1.13.0-SNAPSHOT`) Create an audit record for every changed property of every changed object within a transaction.
+|Create an audit record for every changed property of every changed object within a transaction.
|`AuditerServiceLogging` +
also +
`AuditerServiceUsingJdo` +
@@ -38,7 +38,7 @@ also +
|xref:rgsvc.adoc#_rgsvc_spi_AuditingService[`o.a.i.applib.` +
`services.audit` +
`AuditingService3`]
-|(deprecated in `1.13.0-SNAPSHOT`, replaced by xref:rgsvc.adoc#_rgsvc_spi_AuditerService[`AuditerService`]); creates
+|(deprecated, replaced by xref:rgsvc.adoc#_rgsvc_spi_AuditerService[`AuditerService`]); creates
an audit record for every changed property of every changed object within a transaction.
|
|
@@ -47,7 +47,7 @@ an audit record for every changed property of every changed object within a tran
|xref:rgsvc.adoc#_rgsvc_spi_EventSerializer[`o.a.i.applib.` +
`services.publish` +
`EventSerializer`]
-|(deprecated in `1.13.0-SNAPSHOT`) Creates a representation of either an action invocation or a changed object being published through the xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`PublishingService`].
+|(deprecated, not used by replacement xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`]) Creates a representation of either an action invocation or a changed object being published through the xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`PublishingService`].
|`RestfulObjects-` +
`SpecEventSerializer` +
``o.ia.m.publishing`` +
@@ -59,7 +59,7 @@ an audit record for every changed property of every changed object within a tran
|xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`o.a.i.applib.` +
`services.publish` +
`PublisherService`]
-|(`1.13.0-SNAPSHOT`) Publish any action invocations/property edits and changed objects, typically for interchange with an external system in a different bounded context.
+|Publish any action invocations/property edits and changed objects, typically for interchange with an external system in a different bounded context.
|`PublisherServiceLogging` +
also +
``PublisherService-`` +
@@ -73,7 +73,7 @@ also +
|xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`o.a.i.applib.` +
`services.publish` +
`PublishingService`]
-|(deprecated in `1.13.0-SNAPSHOT`) Publish any action invocations and changed objects, typically for interchange with an external system in a different bounded context.
+|(deprecated, replaced by xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`]) Publish any action invocations and changed objects, typically for interchange with an external system in a different bounded context.
|`PublishingService` +
``o.ia.m.publishing`` +
``isis-module-publishing``
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_AuditerService.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_AuditerService.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_AuditerService.adoc
index 46c4b08..332e99b 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_AuditerService.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_AuditerService.adoc
@@ -1,5 +1,5 @@
[[_rgsvc_spi_AuditerService]]
-= `AuditerService` (`1.13.0-SNAPSHOT`)
+= `AuditerService`
: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 agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
:_basedir: ../
:_imagesdir: images/
@@ -12,7 +12,7 @@ The `AuditerService` auditing service provides a simple mechanism to capture cha
[NOTE]
====
This service is intended to replace the now-deprecated xref:rgsvc.adoc#_rgsvc_spi_AuditingService[`AuditingService3`].
-The difference between the two is that this service recognises that the `transactionId` is now (in `1.13.0-SNAPSHOT`)
+The difference between the two is that this service recognises that the `transactionId` is now (as of `1.13.0`)
actually a request/interaction Id, and that an additional `sequence
====
@@ -123,8 +123,8 @@ execution captures the _cause_ of an interaction (an action was invoked, a prope
[NOTE]
====
-Prior to `1.13.0-SNAPSHOT` the xref:rgsvc.adoc#_rgsvc_spi_CommandService[`CommandService`] performed a similar role,
-of capturing the cause. As of `1.13.0-SNAPSHOT`, ``Command``s are now primarily to capture the _intent_ of an action,
+Prior to `1.13.0` the xref:rgsvc.adoc#_rgsvc_spi_CommandService[`CommandService`] performed a similar role,
+of capturing the cause. As of `1.13.0`, ``Command``s are now primarily to capture the _intent_ of an action,
not the actual action invocation itself.
====
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_AuditingService.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_AuditingService.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_AuditingService.adoc
index 2d473e1..e48f5b0 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_AuditingService.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_AuditingService.adoc
@@ -78,6 +78,6 @@ implementing a xref:ugbtb.adoc#_ugbtb_decoupling_vetoing-visibility[vetoing subs
== Related Services
This service has been deprecated and replaced by the equivalent
-xref:rgsvc.adoc#_rgsvc_spi_AuditerService[`AuditerService`] (`1.13.0-SNAPSHOT`).
+xref:rgsvc.adoc#_rgsvc_spi_AuditerService[`AuditerService`].
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_CommandMementoService.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_CommandMementoService.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_CommandMementoService.adoc
deleted file mode 100644
index bfaf381..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_CommandMementoService.adoc
+++ /dev/null
@@ -1,7 +0,0 @@
-[[_rgsvc_spi_CommandMementoService]]
-= `CommandMementoService` (`1.13.0-SNAPSHOT`)
-: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 agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_CommandService.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_CommandService.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_CommandService.adoc
index ee48851..79e09c6 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_CommandService.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_CommandService.adoc
@@ -9,7 +9,7 @@
The `CommandService` service supports the xref:rgsvc.adoc#_rgsvc_api_CommandContext[`CommandContext`] service such
that `Command` objects (that reify the invocation of an action/edit of a property on a domain object) can be persisted.
-As of `1.13.0-SNAPSHOT`, the primary use case for persistent ``Command``s is in support of background commands; they
+As of `1.13.0`, the primary use case for persistent ``Command``s is in support of background commands; they
act as a parent to any background commands that can be persisted either explicitly using the
xref:rgsvc.adoc#_rgsvc_api_BackgroundService[`BackgroundService`], or implicitly by way of the
xref:rgant.adoc#_rgant-Action_command[`@Action#command()`] annotation.
@@ -17,15 +17,16 @@ xref:rgant.adoc#_rgant-Action_command[`@Action#command()`] annotation.
In previous versions of the framework, persistent ``Command``s also supported a number of other use cases:
* they enable profiling of the running application (which actions are invoked then most often, what is their response time)
-* if xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`PublishingService`] or
-xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`] (`1.13.0-SNAPSHOT`) is configured, they provide better traceability
-as the `Command` is also correlated with any published events, again through the unique `transactionId` GUID
-* if xref:rgsvc.adoc#_rgsvc_spi_AuditService[`AuditingService`] or
- xref:rgsvc.adoc#_rgsvc_spi_AuderService[`AuditerService`] (`1.13.0-SNAPSHOT`) is configured, they provide better audit
- information, since the `Command` (the 'cause' of an action) can be correlated to the audit records (the "effect" of
- the action) through the `transactionId` GUID
-
-As of `1.13.0-SNAPSHOT`, these other uses cases are now more fully supported through the
+* if xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`] or
+xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`PublishingService`] (latter deprecated) is configured, they provide
+better traceability as the `Command` is also correlated with any published events, again through the unique
+`transactionId` GUID
+* if xref:rgsvc.adoc#_rgsvc_spi_AuderService[`AuditerService`] or
+xref:rgsvc.adoc#_rgsvc_spi_AuditService[`AuditingService`] (latter deprecated) is configured, they provide better audit
+information, since the `Command` (the 'cause' of an action) can be correlated to the audit records (the "effect" of
+the action) through the `transactionId` GUID
+
+As of `1.13.0`, these other uses cases are now more fully supported through the
xref:rgsvc.adoc#_rgsvc_api_InteractionContext[`InteractionContext`] service and persistent implementations of the
``Interaction`` object, eg as provided by the (non-ASF)
http://github.com/isisaddons/isis-module-publishmq[Isis addons' publishmq] module.
@@ -61,7 +62,7 @@ public interface CommandService {
<1> Instantiate the appropriate instance of the `Command` (as defined by the
xref:rgsvc.adoc#_rgsvc_api_CommandContext[`CommandContext`] service). Its members will be populated automatically by
the framework.
-<2> (as of `1.13.0-SNAPSHOT`) is *NO LONGER CALLED* and is deprecated: the framework automatically populates the ``Command``'s `timestamp`,
+<2> this method (as of `1.13.0`) is *NO LONGER CALLED* and is deprecated: the framework automatically populates the ``Command``'s `timestamp`,
`user` and `transactionId` fields, so there is no need for the service implementation to initialize any of these. In
particular, the ``Command`` will already have been initialized with the provided `transactionId` argument.
<3> Set the hint that the `Command` should be persisted if possible (when completed, see below).
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_EventSerializer.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_EventSerializer.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_EventSerializer.adoc
index 0bd7f6b..afa5556 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_EventSerializer.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_EventSerializer.adoc
@@ -9,8 +9,7 @@ The `EmailSerializer` service is a supporting service intended for use by (any i
[WARNING]
====
-This service is deprecated, replaced with xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`]
-(`1.13.0-SNAPSHOT`).
+This service is deprecated, replaced with xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`].
====
See xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`PublishingService`] for further discussion.
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_PublisherService.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_PublisherService.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_PublisherService.adoc
index 228bda3..4f34104 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_PublisherService.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_PublisherService.adoc
@@ -1,12 +1,12 @@
[[_rgsvc_spi_PublisherService]]
-= `PublisherService` (`1.13.0-SNAPSHOT`)
+= `PublisherService`
: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 agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
:_basedir: ../
:_imagesdir: images/
-The `PublisherService` API (`1.13.0-SNAPSHOT`) is intended for coarse-grained publish/subscribe for system-to-system interactions, from Apache Isis to some other system. Events that can be published are action invocations/property
+The `PublisherService` API is intended for coarse-grained publish/subscribe for system-to-system interactions, from Apache Isis to some other system. Events that can be published are action invocations/property
edits, and changed objects. A typical use case is to publish onto a pub/sub bus such as
link:http://activemq.apache.org/[ActiveMQ] with link:http://camel.apache.org[Camel] to keep other systems up to date.
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_PublishingService.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_PublishingService.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_PublishingService.adoc
index 21abd8f..67f0c08 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_PublishingService.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_PublishingService.adoc
@@ -11,7 +11,7 @@ The `PublishingService` API is intended for coarse-grained publish/subscribe for
[WARNING]
====
-This service is deprecated, replaced with xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`] (`1.13.0-SNAPSHOT`).
+This service is deprecated, replaced with xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`].
====
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_ugbtb_deployment_docker.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugbtb_deployment_docker.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugbtb_deployment_docker.adoc
index 4a9580e..26ed652 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugbtb_deployment_docker.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugbtb_deployment_docker.adoc
@@ -1,13 +1,12 @@
[[_ugbtb_deployment_docker]]
-= Docker (`1.13.0-SNAPSHOT`)
+= Docker
: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 agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
:_basedir: ../
:_imagesdir: images/
In addition to loading the regular configuration properties from `WEB-INF` directory (described
-xref:rgcfg.adoc#_rgcfg_configuration-files[here]), Apache Isis will also (as of `1.13.0-SNAPSHOT`)load the
-`overrides.properties` file.
+xref:rgcfg.adoc#_rgcfg_configuration-files[here]), Apache Isis will also load the `overrides.properties` file.
This file is treated slightly differently than the other configuration files; it is loaded last, and any configuration
properties defined in it will _override_ any configuration properties already read from other files (this includes
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_ugbtb_deployment_externalized-configuration.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugbtb_deployment_externalized-configuration.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugbtb_deployment_externalized-configuration.adoc
index 20752f2..17c71ae 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugbtb_deployment_externalized-configuration.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugbtb_deployment_externalized-configuration.adoc
@@ -17,8 +17,8 @@ then the subsequent configuration property will be ignored.
[TIP]
====
-In addition (as of `1.13.0-SNAPSHOT`) the framework will also load the `overrides.properties` file. This is intended
-to support deployment through Docker, as discussed xref:ugbtb.adoc#_ugbtb_deployment_docker[next].
+In addition the framework will also load the `overrides.properties` file. This is intended to support deployment
+through Docker, as discussed xref:ugbtb.adoc#_ugbtb_deployment_docker[next].
====
All of these files are read from the `WEB-INF` directory. Having this configuration "baked into" the application is
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_ugbtb_programming-model_finetuning.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugbtb_programming-model_finetuning.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugbtb_programming-model_finetuning.adoc
index 9319b5a..6e7cf45 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugbtb_programming-model_finetuning.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugbtb_programming-model_finetuning.adoc
@@ -64,21 +64,12 @@ This http://isis.markmail.org/thread/472c3mrvcgnripst[thread] from the users mai
-== Replacing the Prog. Model
-[WARNING]
+[NOTE]
====
-This property is ignored as of `1.13.0-SNAPSHOT`
+Previously (prior to `1.13.0`) the framework also supported the "isis.reflector.facets" configuration property, to
+specify a completely new implementation of the (internal API) `ProgrammingModel`. This is no longer supported; use
+"isis.reflector.facets.include" and "isis.reflector.facet.exclude" to adjust the framework's default implementation
+(called `ProgrammingModelFacetsJava5`).
====
-If you want to make many changes to the programming model, then (rather than include/exclude lots of facet factories) you can specify a completely new programming model. For this you'll first need an implementation of `ProgrammingModel`.
-
-One option is to subclass from `ProgrammingModelFacetsJava5`; in your subclass you could remove any ``FacetFactory``s that you wanted to exclude, as well as registering your own implementations.
-
-To tell Apache Isis to use your new programming model, use:
-
-[source,ini]
-----
-isis.reflector.facets=com.mycompany.myapp.isis.IsisProgrammingModel
-----
-
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_ugfun_core-concepts_building-blocks.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugfun_core-concepts_building-blocks.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugfun_core-concepts_building-blocks.adoc
index 47c7dfb..45e5bef 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugfun_core-concepts_building-blocks.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugfun_core-concepts_building-blocks.adoc
@@ -308,14 +308,13 @@ Some examples:
* the information within an OID could be converted into a barcode, and stamped onto a PDF form. When the PDF is
scanned by the mail room, the barcode could be read to attach the correspondence to the relevant domain object.
-* as a handle to any object in an audit record (as used by xref:rgsvc.adoc#_rgsvc_spi_AuditingService[`AuditingService`]
-or xref:rgsvc.adoc#_rgsvc_spi_AuditerService[`AuditerService`] (`1.13.0-SNAPSHOT`));
+* as a handle to any object in an audit record, as used by xref:rgsvc.adoc#_rgsvc_spi_AuditerService[`AuditerService`] or xref:rgsvc.adoc#_rgsvc_spi_AuditingService[`AuditingService`] (the latter deprecated);
* similarly within implementations of xref:rgsvc.adoc#_rgsvc_spi_CommandService[`CommandService`] to persist `Command`
objects
* similarly within implementations of xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`]
-(`1.13.0-SNAPSHOT`) to persist published action invocations
+to persist published action invocations
* and of course both the xref:ugvro.adoc#[RestfulObjects viewer] and
xref:ugvw.adoc#[Wicket viewer]
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_ugfun_core-concepts_framework-provided-services.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugfun_core-concepts_framework-provided-services.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugfun_core-concepts_framework-provided-services.adoc
index 60ba2d6..a12c999 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugfun_core-concepts_framework-provided-services.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugfun_core-concepts_framework-provided-services.adoc
@@ -33,14 +33,15 @@ Commands/Interactions/Background/Auditing/Publishing/Profiling:
* xref:rgsvc.adoc#_rgsvc_spi_CommandService[`CommandService`] (SPI)
* xref:rgsvc.adoc#_rgsvc_spi_CommandMementoService[`CommandMementoService`] (SPI)
* xref:rgsvc.adoc#_rgsvc_api_InteractionContext[`InteractionContext`] (SPI)
-* xref:rgsvc.adoc#_rgsvc_spi_AuditingService[`AuditingService`] (SPI)
-* xref:rgsvc.adoc#_rgsvc_spi_AuditerService[`AuditerService`] (SPI) (`1.13.0-SNAPSHOT`)
+* xref:rgsvc.adoc#_rgsvc_spi_AuditingService[`AuditingService`] (SPI) (deprecated)
+* xref:rgsvc.adoc#_rgsvc_spi_AuditerService[`AuditerService`] (SPI)
* xref:rgsvc.adoc#_rgsvc_api_BackgroundService[`BackgroundService`]
* xref:rgsvc.adoc#_rgsvc_spi_BackgroundCommandService[`BackgroundCommandService`] (SPI)
-* xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`PublishingService`] (SPI)
-* xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublishererService`] (SPI) (`1.13.0-SNAPSHOT`)
+* xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`PublishingService`] (SPI) (deprecated)
+* xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublishererService`] (SPI)
* xref:rgsvc.adoc#_rgsvc_api_MetricsService[`MetricsService`]
+
Information Sharing:
* xref:rgsvc.adoc#_rgsvc_api_Scratchpad[`Scratchpad`]
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_ugfun_getting-started_simpleapp-archetype.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugfun_getting-started_simpleapp-archetype.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugfun_getting-started_simpleapp-archetype.adoc
index 3fb3e07..cf507a6 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugfun_getting-started_simpleapp-archetype.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugfun_getting-started_simpleapp-archetype.adoc
@@ -49,7 +49,7 @@ The process is almost identical to that for stable releases, however the `archet
mvn archetype:generate \
-D archetypeGroupId=org.apache.isis.archetype \
-D archetypeArtifactId=simpleapp-archetype \
- -D archetypeVersion=1.13.0-SNAPSHOT \
+ -D archetypeVersion=1.14.0-SNAPSHOT \
-D groupId=com.mycompany \
-D artifactId=myapp \
-D version=1.0-SNAPSHOT \
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_ugfun_jdo-mappings_1-to-m-bidirectional-relationships.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugfun_jdo-mappings_1-to-m-bidirectional-relationships.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugfun_jdo-mappings_1-to-m-bidirectional-relationships.adoc
index a28e893..0623e67 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugfun_jdo-mappings_1-to-m-bidirectional-relationships.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugfun_jdo-mappings_1-to-m-bidirectional-relationships.adoc
@@ -16,7 +16,7 @@ In addition, the two entities can be associated either without or with a join ta
* without a join table is more common; a regular foreign key in the child table for `FermentationVessel` points back up to the associated parent `Batch`
* with a join table; a link table holds the tuple representing the linkage.
-Testing in `1.13.0-SNAPSHOT` (against `dn-core 4.1.7`/`dn-rdbms 4.1.9`) has determined there are two main rules:
+Testing (as of `1.13.0`, against `dn-core 4.1.7`/`dn-rdbms 4.1.9`) has determined there are two main rules:
* If not using `@Join`, then the association must be maintained by setting the child association on the parent. +
+
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_ugsec_configuring-isis-to-use-shiro.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugsec_configuring-isis-to-use-shiro.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugsec_configuring-isis-to-use-shiro.adoc
index 27d73ed..9604eaf 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugsec_configuring-isis-to-use-shiro.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugsec_configuring-isis-to-use-shiro.adoc
@@ -30,7 +30,7 @@ The figure above doesn't tell the whole story; we haven't yet seen how Shiro its
== Configuring Isis' Shiro Authenticator
-The `ShiroAuthenticatorOrAuthorizor` class itself supports a single optional property (`1.13.0-SNAPSHOT`). This can
+The `ShiroAuthenticatorOrAuthorizor` class itself supports a single optional property. This can
be configured in `authentication_shiro.properties` file:
[source,ini]
@@ -43,7 +43,7 @@ the Shiro subject - if found to be still authenticated - will be logged out anyw
[WARNING]
====
-This auto-logout behaviour was the default prior to `1.13.0-SNAPSHOT`, but is believed to be the root cause of some
+This auto-logout behaviour was the default prior to `1.13.0`, but is believed to be the root cause of some
exceptions caused by a possible race condition. There should generally be no need to change this property from its
default (`false`).
====
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties.adoc
index 618be8b..619ac65 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties.adoc
@@ -60,7 +60,7 @@ converted dynamically into the corresponding `moment.js` format.
`datePicker.maxDate`
| ISO format date +
(`2100-01-01T00:00:00.000Z`)
-|(`1.13.0-SNAPSHOT`), specifies a maximum date after which dates may not be specified.
+|Specifies a maximum date after which dates may not be specified.
See link:http://eonasdan.github.io/bootstrap-datetimepicker/Options/#maxdate[datetimepicker reference docs] for
further details. The string must be in ISO date format (see link:https://github.com/moment/moment/issues/1407[here]
@@ -70,7 +70,7 @@ for further details).
`datePicker.minDate`
| ISO format date +
(`1900-01-01T00:00:00.000Z`)
-|(`1.13.0-SNAPSHOT`), specifies a minimum date before which dates may not be specified.
+|Specifies a minimum date before which dates may not be specified.
See link:http://eonasdan.github.io/bootstrap-datetimepicker/Options/#mindate[datetimepicker reference docs] for
further details. The string must be in ISO date format (see link:https://github.com/moment/moment/issues/1407[here]
@@ -89,7 +89,7 @@ for further details).
|`isis.viewer.wicket.` +
`liveReloadUrl`
| URL
-|(`1.13.0-SNAPSHOT`), specifies the URL if xref:dg.adoc#_dg_ide_intellij_advanced_gradle-liveReload[live reload] is set up, eg: +
+|Specifies the URL if xref:dg.adoc#_dg_ide_intellij_advanced_gradle-liveReload[live reload] is set up, eg: +
`http://localhost:35729/livereload.js?snipver=1`
@@ -117,7 +117,7 @@ for further details).
|`isis.viewer.wicket.` +
`rememberMe.cookieKey`
| ascii chars (`_isisWicketRememberMe_`)
-| (`1.13.0-SNAPSHOT`) Cookie key holding the (encrypted) 'rememberMe' user/password. There is generally no need to
+|Cookie key holding the (encrypted) 'rememberMe' user/password. There is generally no need to
change this. +
Valid values as per link:http://stackoverflow.com/a/1969339/56880[this StackOverflow answer].
@@ -125,7 +125,7 @@ Valid values as per link:http://stackoverflow.com/a/1969339/56880[this StackOver
|`isis.viewer.wicket.` +
`rememberMe.encryptionKey`
| any string (a random UUID each time)
-| (`1.13.0-SNAPSHOT`) Encryption key is used to encrypt the rememberMe user/password. +
+|Encryption key is used to encrypt the rememberMe user/password. +
It should be set to a unique and private value. If a hard-coded and publicly known value is used, then it would be
possible for rememberMe user/password to be intercepted and decrypted, compromising access.
@@ -137,7 +137,7 @@ to log in again).
|`isis.viewer.wicket.` +
`rememberMe.suppress`
| `true`,`false` (`_false_`)
-| (`1.13.0-SNAPSHOT`) Whether to suppress "remember me" checkbox on the login page.
+|Whether to suppress "remember me" checkbox on the login page.
|`isis.viewer.wicket.` +
@@ -153,7 +153,7 @@ to log in again).
|`isis.viewer.wicket.` +
`suppressRememberMe`
| `true`,`false` (`_false_`)
-|(Deprecated in `1.13.0-SNAPSHOT`, replaced by `rememberMe.suppress`). Whether to suppress "remember me" checkbox on the login page.
+|(Deprecated in `1.13.0`, replaced by `rememberMe.suppress`). Whether to suppress "remember me" checkbox on the login page.
|`isis.viewer.wicket.` +
`suppressSignUp`
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_suppressing-remember-me.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_suppressing-remember-me.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_suppressing-remember-me.adoc
index 83c32bb..c6aa669 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_suppressing-remember-me.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugvw_configuration-properties_suppressing-remember-me.adoc
@@ -24,18 +24,10 @@ image::{_imagesdir}wicket-viewer/suppress-remember-me/login-page-suppress-rememb
== Configuration
-To suppress the 'remember me' checkbox, add the following configuration flag (`1.13.0-SNAPSHOT`):
+To suppress the 'remember me' checkbox, add the following configuration flag:
[source,ini]
----
isis.viewer.wicket.rememberMe.suppress=true
----
-Prior to `1.13.0-SNAPSHOT`, the configuration property is:
-
-[source,ini]
-----
-isis.viewer.wicket.suppressRememberMe=true
-----
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/ugsec.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/ugsec.adoc b/adocs/documentation/src/main/asciidoc/guides/ugsec.adoc
index 099d660..3a4283a 100644
--- a/adocs/documentation/src/main/asciidoc/guides/ugsec.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/ugsec.adoc
@@ -66,7 +66,7 @@ In addition to Apache Isis' Shiro-based implementation of its authentication and
====
A further aspect of security is auditing: recording what data was modified by which user.
-As of `1.13.0-SNAPSHOT` Apache Isis provides the xref:rgsvc.adoc#_rgsvc_api_InteractionContext[`InteractionContext`]
+Apache Isis provides the xref:rgsvc.adoc#_rgsvc_api_InteractionContext[`InteractionContext`]
can be used to track the actions being invoked, and the xref:rgsvc.adoc#_rgsvc_spi_AuditerService[`AuditerService`]
captures what data was modified as a result (auditing). When ``Interaction``s are persisted (eg by way of
(non-ASF) http://github.com/isisaddons/isis-module-publishmq[Isis addons' publishmq] module) this provides excellent