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:07 UTC
[14/21] isis git commit: ISIS-1335: updates docs,
removing references to 1.13.0-SNAPSHOT
ISIS-1335: updates docs, removing references to 1.13.0-SNAPSHOT
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/7f83398c
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/7f83398c
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/7f83398c
Branch: refs/heads/master
Commit: 7f83398c5f3ab8a564808b395f6c90fdea8ea5e5
Parents: 3af3ab3
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Mon Jul 11 20:23:27 2016 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Mon Jul 11 20:23:27 2016 +0100
----------------------------------------------------------------------
.../_migration-notes_1.12.0-to-1.13.0.adoc | 5 ---
.../main/asciidoc/_release-notes_1.13.0.adoc | 7 +---
.../guides/_cgcom_cutting-a-release.adoc | 34 +++++++++---------
.../guides/_cgcom_post-release-successful.adoc | 37 ++++++++++----------
.../main/asciidoc/guides/_dg_ide_intellij.adoc | 3 +-
.../guides/_rgant-Action_publishing.adoc | 5 ++-
.../asciidoc/guides/_rgant-DomainObject.adoc | 4 +--
...ant-DomainObject_autoCompleteRepository.adoc | 2 +-
.../guides/_rgant-DomainObject_publishing.adoc | 4 +--
.../main/asciidoc/guides/_rgant-Nullable.adoc | 4 +--
.../main/asciidoc/guides/_rgant-Parameter.adoc | 6 ++--
.../guides/_rgant-Parameter_fileAccept.adoc | 4 +--
.../guides/_rgant-Parameter_optionality.adoc | 2 +-
.../main/asciidoc/guides/_rgant-Property.adoc | 6 ++--
.../guides/_rgant-Property_fileAccept.adoc | 4 +--
.../guides/_rgant-Property_optionality.adoc | 2 +-
.../guides/_rgant-Property_publishing.adoc | 4 +--
.../main/asciidoc/guides/_rgant_aaa_jee.adoc | 2 +-
.../guides/_rgcfg_configuring-core.adoc | 24 ++++++-------
.../guides/_rgcfg_specifying-components.adoc | 12 ++-----
...ms_classes_contributee_HasTransactionId.adoc | 2 +-
...s_classes_domainevent_ActionDomainEvent.adoc | 4 +--
.../main/asciidoc/guides/_rgcms_schema-aim.adoc | 4 +--
.../main/asciidoc/guides/_rgcms_schema-chg.adoc | 4 +--
.../main/asciidoc/guides/_rgcms_schema-cmd.adoc | 6 ++--
.../asciidoc/guides/_rgcms_schema-common.adoc | 6 ++--
.../main/asciidoc/guides/_rgcms_schema-ixn.adoc | 4 +--
.../src/main/asciidoc/guides/_rgcms_schema.adoc | 10 +++---
.../guides/_rgfis_application-layer.adoc | 4 +--
.../guides/_rgfis_persistence-layer.adoc | 8 ++---
.../_rgfis_spi_AuditingServiceInternal.adoc | 4 +--
...rgfis_spi_ChangedObjectsServiceInternal.adoc | 4 +--
.../_rgfis_spi_CommandDtoServiceInternal.adoc | 4 +--
...rgfis_spi_InteractionDtoServiceInternal.adoc | 4 +--
.../_rgfis_spi_PublishingServiceInternal.adoc | 8 ++---
.../main/asciidoc/guides/_rgmvn_validate.adoc | 2 +-
.../src/main/asciidoc/guides/_rgmvn_xsd.adoc | 2 +-
.../guides/_rgsvc_api_BackgroundService.adoc | 9 +++--
.../guides/_rgsvc_api_BookmarkService.adoc | 4 +--
.../guides/_rgsvc_api_CommandContext.adoc | 20 ++++-------
.../guides/_rgsvc_api_InteractionContext.adoc | 4 +--
.../guides/_rgsvc_api_MementoService.adoc | 13 ++++---
.../guides/_rgsvc_api_MetamodelService.adoc | 5 ++-
.../guides/_rgsvc_api_MetricsService.adoc | 4 +--
.../guides/_rgsvc_api_RepositoryService.adoc | 8 ++---
.../guides/_rgsvc_api_ServiceRegistry.adoc | 6 ++--
.../guides/_rgsvc_application-layer-api.adoc | 2 +-
.../src/main/asciidoc/guides/_rgsvc_intro.adoc | 6 ++--
.../guides/_rgsvc_persistence-layer-spi.adoc | 10 +++---
.../guides/_rgsvc_spi_AuditerService.adoc | 8 ++---
.../guides/_rgsvc_spi_AuditingService.adoc | 2 +-
.../_rgsvc_spi_CommandMementoService.adoc | 7 ----
.../guides/_rgsvc_spi_CommandService.adoc | 23 ++++++------
.../guides/_rgsvc_spi_EventSerializer.adoc | 3 +-
.../guides/_rgsvc_spi_PublisherService.adoc | 4 +--
.../guides/_rgsvc_spi_PublishingService.adoc | 2 +-
.../guides/_ugbtb_deployment_docker.adoc | 5 ++-
...b_deployment_externalized-configuration.adoc | 4 +--
.../_ugbtb_programming-model_finetuning.adoc | 19 +++-------
.../_ugfun_core-concepts_building-blocks.adoc | 5 ++-
...re-concepts_framework-provided-services.adoc | 9 ++---
...fun_getting-started_simpleapp-archetype.adoc | 2 +-
...ings_1-to-m-bidirectional-relationships.adoc | 2 +-
.../_ugsec_configuring-isis-to-use-shiro.adoc | 4 +--
.../guides/_ugvw_configuration-properties.adoc | 14 ++++----
...tion-properties_suppressing-remember-me.adoc | 10 +-----
.../src/main/asciidoc/guides/ugsec.adoc | 2 +-
67 files changed, 207 insertions(+), 260 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/_migration-notes_1.12.0-to-1.13.0.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/_migration-notes_1.12.0-to-1.13.0.adoc b/adocs/documentation/src/main/asciidoc/_migration-notes_1.12.0-to-1.13.0.adoc
index 2864fa4..134bbc2 100644
--- a/adocs/documentation/src/main/asciidoc/_migration-notes_1.12.0-to-1.13.0.adoc
+++ b/adocs/documentation/src/main/asciidoc/_migration-notes_1.12.0-to-1.13.0.adoc
@@ -10,11 +10,6 @@ Existing projects written against v1.12.x should run against v1.13.0 with few if
any difficulties then let us know via the link:support.html[users mailing list], so we can support you and document
issues here.
-[NOTE]
-====
-`1.13.0-SNAPSHOT` is currently still in development.
-====
-
== Faster startup times
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/_release-notes_1.13.0.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/_release-notes_1.13.0.adoc b/adocs/documentation/src/main/asciidoc/_release-notes_1.13.0.adoc
index 0d28078..e61e576 100644
--- a/adocs/documentation/src/main/asciidoc/_release-notes_1.13.0.adoc
+++ b/adocs/documentation/src/main/asciidoc/_release-notes_1.13.0.adoc
@@ -6,11 +6,6 @@
:toc: right
-[NOTE]
-====
-Apache Isis 1.13.0 is not yet released (is still formally `1.13.0-SNAPSHOT`), but voting for RC1 is currently underway.
-====
-
Apache Isis 1.13.0 improves and formalizes the support for commands and auditing, and introduces the new concept of an
interaction. A command now represents the _intention_ to interact with the application, either to invoke an action or
to edit a property. This is captured as a JAXB DTO. An interaction on the other hand captures the fact that a
@@ -125,7 +120,7 @@ The release also includes a great deal of internal refactorings and simplificati
* link:https://issues.apache.org/jira/browse/ISIS-1461[ISIS-1461] - More reliable fix to concurrency exception
* link:https://issues.apache.org/jira/browse/ISIS-1458[ISIS-1458] - Possible incomplete auditing for "non-trivial" updates
* link:https://issues.apache.org/jira/browse/ISIS-1454[ISIS-1454] - Hints for drop-downs in Wicket viewer not honoured.
-* link:https://issues.apache.org/jira/browse/ISIS-1453[ISIS-1453] - SessionManagementService#nextSession broken (in 1.13.0-SNAPSHOT)
+* link:https://issues.apache.org/jira/browse/ISIS-1453[ISIS-1453] - SessionManagementService#nextSession broken
* link:https://issues.apache.org/jira/browse/ISIS-1452[ISIS-1452] - Throwing an exception (for -SNAPSHOT) does not abort the transaction.
* link:https://issues.apache.org/jira/browse/ISIS-1444[ISIS-1444] - Mark applib FixtureScript.Execution methods as @Programmatic to avoid being added to the metamodel
* link:https://issues.apache.org/jira/browse/ISIS-1436[ISIS-1436] - When executing a bulk action on a paginated collection items, chosen items can be ignored unintentionally
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_cgcom_cutting-a-release.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_cgcom_cutting-a-release.adoc b/adocs/documentation/src/main/asciidoc/guides/_cgcom_cutting-a-release.adoc
index d1b9566..4c11c75 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_cgcom_cutting-a-release.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_cgcom_cutting-a-release.adoc
@@ -47,8 +47,8 @@ We use environment variables to parameterize as many of the steps as possible.
----
cd core
export ISISTMP=/c/tmp # <1>
-export ISISDEV=1.14.0-SNAPSHOT
-export ISISREL=1.13.0
+export ISISDEV=1.15.0-SNAPSHOT
+export ISISREL=1.14.0
export ISISRC=RC1
export ISISBRANCH=release-$ISISREL-$ISISRC
export ISISJIRA=ISIS-9999 # <2>
@@ -64,7 +64,7 @@ Obviously, alter `$ISISDEV` and `$ISISREL` as required, and bump `$ISISRC` for r
[IMPORTANT]
====
-Note that the branch name is *not* the same any of the eventual tag names (eg `isis-1.13.0` or `simpleapp-archetype-1.13.0`).
+Note that the branch name is *not* the same any of the eventual tag names (eg `isis-1.14.0` or `simpleapp-archetype-1.14.0`).
If they did have the same name, then what would happen is that the `maven-release-plugin` would checkout the (HEAD of the) branch and thus upload a SNAPSHOT to the snapshot repository. What it should of course do is checkout the tag and then upload that to the release staging repository.
====
@@ -88,13 +88,13 @@ All release preparation is done locally; if we are successful, this branch will
Double check that the version number of the parent pom should reflect the branch name that you are now on (with a `-SNAPSHOT` suffix). his will normally have been done already during earlier development; but confirm that it has been updated. If it has not, make the change.
-Double check that the version number of the core POM (`core/pom.xml`) should reflect the branch name that you are now on. For example, if releasing version `1.13.0`, the POM should read:
+Double check that the version number of the core POM (`core/pom.xml`) should reflect the branch name that you are now on. For example, if releasing version `1.14.0`, the POM should read:
[source,xml]
----
<groupId>org.apache.isis.core</groupId>
<artifactId>isis</artifactId>
-<version>1.13.0-SNAPSHOT</version>
+<version>1.14.0-SNAPSHOT</version>
----
Also, check that there are no snapshot dependencies:
@@ -284,7 +284,7 @@ If there are any snags at this stage, then explicitly delete the generated `rele
[[_cgcom_cutting-a-release_releasing-core_post-prepare-sanity-check]]
=== Post-prepare sanity check
-You should end up with artifacts in your local repo with the new version (eg `1.13.0`). This is a good time to do some quick sanity checks; nothing has yet been uploaded:
+You should end up with artifacts in your local repo with the new version (eg `1.14.0`). This is a good time to do some quick sanity checks; nothing has yet been uploaded:
* unzip the source-release ZIP and check it builds.
* Inspect the `DEPENDENCIES` file, and check it looks correct.
@@ -340,17 +340,17 @@ The custom `workingDirectory` prevents file path issues if releasing on Windows.
[INFO] Performing a LOCAL checkout from scm:git:file:///C:\APACHE\isis-git-rw\co
re
[INFO] Checking out the project to perform the release ...
-[INFO] Executing: cmd.exe /X /C "git clone --branch release-1.13.0 file:///C:\APACHE\isis-git-rw\core C:\APACHE\isis-git-rw\core\target\checkout"
+[INFO] Executing: cmd.exe /X /C "git clone --branch release-1.14.0 file:///C:\APACHE\isis-git-rw\core C:\APACHE\isis-git-rw\core\target\checkout"
[INFO] Working directory: C:\APACHE\isis-git-rw\core\target
[INFO] Performing a LOCAL checkout from scm:git:file:///C:\APACHE\isis-git-rw
[INFO] Checking out the project to perform the release ...
-[INFO] Executing: cmd.exe /X /C "git clone --branch release-1.13.0 file:///C:\APACHE\isis-git-rw C:\APACHE\isis-git-rw\core\target\checkout"
+[INFO] Executing: cmd.exe /X /C "git clone --branch release-1.14.0 file:///C:\APACHE\isis-git-rw C:\APACHE\isis-git-rw\core\target\checkout"
[INFO] Working directory: C:\APACHE\isis-git-rw\core\target
[INFO] Executing: cmd.exe /X /C "git ls-remote file:///C:\APACHE\isis-git-rw"
[INFO] Working directory: C:\Users\ADMINI~1\AppData\Local\Temp
[INFO] Executing: cmd.exe /X /C "git fetch file:///C:\APACHE\isis-git-rw"
[INFO] Working directory: C:\APACHE\isis-git-rw\core\target\checkout
-[INFO] Executing: cmd.exe /X /C "git checkout release-1.13.0"
+[INFO] Executing: cmd.exe /X /C "git checkout release-1.14.0"
[INFO] Working directory: C:\APACHE\isis-git-rw\core\target\checkout
[INFO] Executing: cmd.exe /X /C "git ls-files"
[INFO] Working directory: C:\APACHE\isis-git-rw\core\target\checkout
@@ -403,7 +403,7 @@ Update the parent `pom.xml` to reference the _released_ version of Apache Isis c
[source,xml]
----
<properties>
- <isis.version>1.13.0</isis.version>
+ <isis.version>1.14.0</isis.version>
...
</properties>
----
@@ -650,7 +650,7 @@ Use the following subject, eg:
[source,bash]
----
-[VOTE] Apache Isis Core release 1.13.0 RC1
+[VOTE] Apache Isis Core release 1.14.0 RC1
----
And use the following body:
@@ -659,17 +659,17 @@ And use the following body:
----
I've cut a release for Apache Isis Core and the simpleapp archetype:
-* Core 1.13.0
-* SimpleApp Archetype 1.13.0
+* Core 1.14.0
+* SimpleApp Archetype 1.14.0
The source code artifacts have been uploaded to staging repositories on repository.apache.org:
-* http://repository.apache.org/content/repositories/orgapacheisis-10xx/org/apache/isis/core/isis/1.13.0/isis-1.13.0-source-release.zip
-* http://repository.apache.org/content/repositories/orgapacheisis-10xx/org/apache/isis/archetype/simpleapp-archetype/1.13.0/simpleapp-archetype-1.13.0-source-release.zip
+* http://repository.apache.org/content/repositories/orgapacheisis-10xx/org/apache/isis/core/isis/1.14.0/isis-1.14.0-source-release.zip
+* http://repository.apache.org/content/repositories/orgapacheisis-10xx/org/apache/isis/archetype/simpleapp-archetype/1.14.0/simpleapp-archetype-1.14.0-source-release.zip
For each zip there is a corresponding signature file (append .asc to the zip's url).
-In the source code repo the code has been tagged as isis-1.13.0-RC1 and simpleapp-archetype-1.13.0-RC1; see https://git-wip-us.apache.org/repos/asf?p=isis.git
+In the source code repo the code has been tagged as isis-1.14.0-RC1 and simpleapp-archetype-1.14.0-RC1; see https://git-wip-us.apache.org/repos/asf?p=isis.git
For instructions on how to verify the release (build from binaries and/or use in Maven directly), see http://isis.apache.org/guides/cgcom.html#_cgcom_verifying-releases
@@ -682,7 +682,7 @@ Please verify the release and cast your vote. The vote will be open for a minim
Remember to update:
-* the version number (1.13.0 or whatever)
+* the version number (1.14.0 or whatever)
* the release candidate number (`RC1` or whatever)
* the repository id, as provided by Nexus earlier (`orgapacheisis-10xx` or whatever)
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_cgcom_post-release-successful.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_cgcom_post-release-successful.adoc b/adocs/documentation/src/main/asciidoc/guides/_cgcom_post-release-successful.adoc
index d4c5aba..c258be8 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_cgcom_post-release-successful.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_cgcom_post-release-successful.adoc
@@ -25,7 +25,7 @@ Post the results to the `dev@isis.a.o` mailing list:
[source,bash]
----
-[RESULT] [VOTE] Apache Isis Core release 1.13.0
+[RESULT] [VOTE] Apache Isis Core release 1.14.0
----
using the body (alter last line as appropriate):
@@ -53,8 +53,8 @@ You can do this using the `scripts/promoterctag.sh` script; for example:
[source,bash]
----
-sh scripts/promoterctag.sh isis-1.13.0 RC1
-sh scripts/promoterctag.sh simpleapp-archetype-1.13.0 RC1
+sh scripts/promoterctag.sh isis-1.14.0 RC1
+sh scripts/promoterctag.sh simpleapp-archetype-1.14.0 RC1
----
This script pushes the tag under `refs/tags/rel`. As per Apache policy (communicated on 10th Jan 2016 to Apache PMCs),
@@ -159,7 +159,7 @@ popd
[source,bash]
----
-sh upd.sh 1.12.2 1.13.0
+sh upd.sh 1.14.0 1.15.0
----
The script downloads the artifacts from the Nexus release repository, adds the artifacts to subversion and deletes the previous version.
@@ -192,7 +192,7 @@ From the root directory, generate the release notes for the current release, in
[source,bash]
----
-sh scripts/jira-release-notes.sh ISIS 1.13.0 > /tmp/1
+sh scripts/jira-release-notes.sh ISIS 1.14.0 > /tmp/1
----
@@ -257,14 +257,14 @@ For example, for a release of Apache Isis Core, use the following subject:
[source,bash]
----
-[ANN] Apache Isis version 1.13.0 Released
+[ANN] Apache Isis version 1.14.0 Released
----
And use the following body (summarizing the main points as required):
[source]
----
-The Apache Isis team is pleased to announce the release of Apache Isis v1.13.0.
+The Apache Isis team is pleased to announce the release of Apache Isis v1.14.0.
New features in this release include:
* ...
@@ -278,8 +278,8 @@ Enjoy!
--The Apache Isis team
-[1] http://isis.apache.org/release-notes.html#r1.13.0
-[2] http://isis.apache.org/migration-notes.html#_migration-notes_1.12.0-to-1.13.0
+[1] http://isis.apache.org/release-notes.html#r1.14.0
+[2] http://isis.apache.org/migration-notes.html#_migration-notes_1.13.0-to-1.14.0
[3] http://search.maven.org
[4] http://isis.apache.org/downloads.html
----
@@ -303,13 +303,13 @@ Because we release from a branch, the changes made in the branch (changes to `po
----
git checkout master # update master with latest
git pull
-git merge release-1.13.0-RC1 # merge branch onto master
-git branch -d release-1.13.0-RC1 # branch no longer needed
-git push origin --delete release-1.13.0-RC1 # remote branch no longer needed
+git merge release-1.14.0-RC1 # merge branch onto master
+git branch -d release-1.14.0-RC1 # branch no longer needed
+git push origin --delete release-1.14.0-RC1 # remote branch no longer needed
----
-Finally, update the simpleapp's root `pom.xml` to reference the next SNAPSHOT release (`1.14.0-SNAPSHOT`)
+Finally, update the simpleapp's root `pom.xml` to reference the next SNAPSHOT release (`1.15.0-SNAPSHOT`)
@@ -413,16 +413,15 @@ Using this https://gist.github.com/danhaywood/ff17946ee05652402cfb[gist] to invo
+
[source,bash]
----
-sh forsub.sh sh bumpver_isis.sh 1.13.0
+sh forsub.sh sh bumpver_isis.sh 1.14.0
----
* update the README for each repository
** replace each version with next (ie the "How to Configure/Use" section, and the "Release to Maven Central" section at the end):
-*** replace 1.13.0-SNAPSHOT with 1.14.0-SNAPSHOT
-*** replace 1.12.0 with 1.13.0
-*** replace 1.11.0 with 1.12.0
+*** replace 1.14.0-SNAPSHOT with 1.15.0-SNAPSHOT
+*** replace 1.13.0 with 1.14.0
** update the "Change Log" section
@@ -430,13 +429,13 @@ sh forsub.sh sh bumpver_isis.sh 1.13.0
+
[source,bash]
----
-sh forsub.sh sh release.sh "1.13.0" "1.14.0-SNAPSHOT" "dan@haywood-associates.co.uk" \"this is not really my password\"
+sh forsub.sh sh release.sh "1.14.0" "1.15.0-SNAPSHOT" "dan@haywood-associates.co.uk" \"this is not really my password\"
----
* update its dependency on Apache Isis to reference the next SNAPSHOT version: +
+
[source,bash]
----
-sh forsub.sh sh bumpver_isis.sh "1.14.0-SNAPSHOT"
+sh forsub.sh sh bumpver_isis.sh "1.15.0-SNAPSHOT"
----
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_dg_ide_intellij.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_dg_ide_intellij.adoc b/adocs/documentation/src/main/asciidoc/guides/_dg_ide_intellij.adoc
index 65e9aa0..ec0d388 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_dg_ide_intellij.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_dg_ide_intellij.adoc
@@ -630,8 +630,7 @@ from the command line (in the `dom` module):
image::{_imagesdir}appendices/dev-env/intellij-idea/070-advanced/005-gradle-output.png[width="600px",link="{_imagesdir}appendices/dev-env/intellij-idea/070-advanced/005-gradle-output.png"]
-Live reload also requires that the `isis.viewer.wicket.liveReloadUrl` configuration property (`1.13.0-SNAPSHOT`) is set
-appropriately:
+Live reload also requires that the `isis.viewer.wicket.liveReloadUrl` configuration property is set appropriately:
[source,ini]
.`viewer_wicket.properties`
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgant-Action_publishing.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgant-Action_publishing.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgant-Action_publishing.adoc
index 656d550..10a21e8 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgant-Action_publishing.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgant-Action_publishing.adoc
@@ -9,7 +9,7 @@
The `publishing()` attribute determines whether and how an action invocation is published via the registered
implementation of a xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`PublishingService`]) or
-xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`] (`1.13.0-SNAPSHOT`). This attribute is also
+xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`]. This attribute is also
supported for xref:rgant.adoc#_rgant-DomainObject_publishing[domain objects], where it controls whether changed objects
are published as events, and for xref:rgant.adoc#_rgant_Property_publishing[`@Property#publishing()`], where it controls
whether property edits are published as events.
@@ -62,8 +62,7 @@ this should avoid the necessity to query back for additional information.
[WARNING]
====
-Be aware that this attribute is only honoured by the deprecated ( in `1.13.0-SNAPSHOT`)
-xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`PublishingService`], so should itself be considered as deprecated. It
+Be aware that this attribute is only honoured by the (deprecated) xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`PublishingService`], so should itself be considered as deprecated. It
is ignored by the replacement xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`],
====
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgant-DomainObject.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgant-DomainObject.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgant-DomainObject.adoc
index 07045e5..5fa5f91 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgant-DomainObject.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgant-DomainObject.adoc
@@ -23,8 +23,8 @@ The table below summarizes the annotation's attributes.
|`AS_CONFIGURED`, `ENABLED`, `DISABLED` +
(`AS_CONFIGURED`)
|indicates whether each of the changed properties of an object should be submitted to the registered
-xref:rgsvc.adoc#_rgsvc_spi_AuditingService[`AuditingService`] or
-xref:rgsvc.adoc#_rgsvc_spi_AuditerService[`AuditerService`] (`1.13.0-SNAPSHOT`).
+xref:rgsvc.adoc#_rgsvc_spi_AuditingService[`AuditingService`] (deprecated) or (its replacement)
+xref:rgsvc.adoc#_rgsvc_spi_AuditerService[`AuditerService`]
|xref:rgant.adoc#_rgant-DomainObject_autoCompleteRepository[`autoCompleteRepository()`]
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgant-DomainObject_autoCompleteRepository.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgant-DomainObject_autoCompleteRepository.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgant-DomainObject_autoCompleteRepository.adoc
index 850d0c8..5719056 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgant-DomainObject_autoCompleteRepository.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgant-DomainObject_autoCompleteRepository.adoc
@@ -78,7 +78,7 @@ public class Customers {
----
<1> end-user must enter minimum number of characters to trigger the query
-(As of `1.13.0-SNAPSHOT`), the autocomplete action can also be a regular method, annotated using xref:rgant.adoc#_rgant_Programmatic[`@Programmatic`]:
+The autocomplete action can also be a regular method, annotated using xref:rgant.adoc#_rgant_Programmatic[`@Programmatic`]:
[source,java]
----
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgant-DomainObject_publishing.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgant-DomainObject_publishing.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgant-DomainObject_publishing.adoc
index 2a6aa7a..331f8ed 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgant-DomainObject_publishing.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgant-DomainObject_publishing.adoc
@@ -8,7 +8,7 @@
The `publishing()` attribute determines whether and how a modified object instance is published via the registered
implementation of a xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`PublishingService`]) or
-xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`] (`1.13.0-SNAPSHOT`). This attribute is also supported
+xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`]. This attribute is also supported
for xref:rgant.adoc#_rgant-Action_publishing[actions], where it controls whether action invocations are published as
events, and for xref:rgant.adoc#_rgant_Property_publishing[`@Property#publishing()`], where it controls whether
property edits are published as events.
@@ -57,7 +57,7 @@ this should avoid the necessity to query back for additional information.
[WARNING]
====
-Be aware that this attribute is only honoured by the deprecated ( in `1.13.0-SNAPSHOT`)
+Be aware that this attribute is only honoured by the (deprecated)
xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`PublishingService`], so should itself be considered as deprecated. It
is ignored by the replacement xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`],
====
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgant-Nullable.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgant-Nullable.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgant-Nullable.adoc
index 159a306..9351e0f 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgant-Nullable.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgant-Nullable.adoc
@@ -1,12 +1,12 @@
[[_rgant-Nullable]]
-= `@Nullable` (`javax`) (`1.13.0-SNAPSHOT`)
+= `@Nullable` (`javax`)
: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/
Apache Isis' defaults for properties and parameters is that they are mandatory unless otherwise stated. The
-`@javax.annotation.Nullable` annotation (`1.13.0-SNAPSHOT`) is recognized by Apache Isis for both properties and
+`@javax.annotation.Nullable` annotation is recognized by Apache Isis for both properties and
parameters as means to indicate that the property/parameter is not mandatory.
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgant-Parameter.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgant-Parameter.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgant-Parameter.adoc
index 64d6d92..16bc5f0 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgant-Parameter.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgant-Parameter.adoc
@@ -20,8 +20,10 @@ The table below summarizes the annotation's attributes.
|xref:rgant.adoc#_rgant-Parameter_fileAccept[`fileAccept()`]
|Media type or file extension
-|(`1.13.0-SNAPSHOT`) restrict the files to be uploaded to a xref:rgcms.adoc#_rgcms_classes_value-types_Blob[`Blob`]
- or xref:rgcms.adoc#_rgcms_classes_value-types_Clob[`Clob`].
+|Hints the file type to be uploaded for xref:rgcms.adoc#_rgcms_classes_value-types_Blob[`Blob`]
+ or xref:rgcms.adoc#_rgcms_classes_value-types_Clob[`Clob`]. +
+ +
+ Note that this does not prevent the user from uploading some other file type; rather it merely defaults the file type in the file open dialog.
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgant-Parameter_fileAccept.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgant-Parameter_fileAccept.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgant-Parameter_fileAccept.adoc
index db86b12..54d8d7b 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgant-Parameter_fileAccept.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgant-Parameter_fileAccept.adoc
@@ -1,12 +1,12 @@
[[_rgant-Parameter_fileAccept]]
-= `fileAccept()` (`1.13.0-SNAPSHOT`)
+= `fileAccept()`
: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 `fileAccept()` attribute (`1.13.0-SNAPSHOT`) applies only to xref:rgcms.adoc#_rgcms_classes_value-types_Blob[`Blob`]
+The `fileAccept()` attribute applies only to xref:rgcms.adoc#_rgcms_classes_value-types_Blob[`Blob`]
or xref:rgcms.adoc#_rgcms_classes_value-types_Clob[`Clob`] parameters, indicating the type of file to accept when
uploading a new value. The attribute is also supported on xref:rgant.adoc#_rgant-Property_fileAccept[properties].
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgant-Parameter_optionality.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgant-Parameter_optionality.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgant-Parameter_optionality.adoc
index da8d288..7ad83bd 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgant-Parameter_optionality.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgant-Parameter_optionality.adoc
@@ -38,5 +38,5 @@ public class Customer {
[NOTE]
====
-It is also possible to specify optionality using xref:rgant.adoc#_rgant_Nullable[`@Nullable`] annotation (`1.13.0-SNAPSHOT`).
+It is also possible to specify optionality using xref:rgant.adoc#_rgant_Nullable[`@Nullable`] annotation.
====
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgant-Property.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgant-Property.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgant-Property.adoc
index f2b334e..9d27376 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgant-Property.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgant-Property.adoc
@@ -34,8 +34,10 @@ It is also possible to apply the annotation to actions of domain services that a
|xref:rgant.adoc#_rgant-Property_fileAccept[`fileAccept()`]
|Media type or file extension
-|(`1.13.0-SNAPSHOT`) restrict the files to be uploaded to a xref:rgcms.adoc#_rgcms_classes_value-types_Blob[`Blob`]
- or xref:rgcms.adoc#_rgcms_classes_value-types_Clob[`Clob`].
+|Hints the files to be uploaded to a xref:rgcms.adoc#_rgcms_classes_value-types_Blob[`Blob`]
+ or xref:rgcms.adoc#_rgcms_classes_value-types_Clob[`Clob`]. +
+ +
+Note that this does not prevent the user from uploading some other file type; rather it merely defaults the file type in the file open dialog.
|xref:rgant.adoc#_rgant-Property_hidden[`hidden()`]
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgant-Property_fileAccept.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgant-Property_fileAccept.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgant-Property_fileAccept.adoc
index 4b33b45..6c2869a 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgant-Property_fileAccept.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgant-Property_fileAccept.adoc
@@ -1,12 +1,12 @@
[[_rgant-Property_fileAccept]]
-= `fileAccept()` (`1.13.0-SNAPSHOT`)
+= `fileAccept()`
: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 `fileAccept()` attribute (`1.13.0-SNAPSHOT`) applies only to xref:rgcms.adoc#_rgcms_classes_value-types_Blob[`Blob`]
+The `fileAccept()` attribute applies only to xref:rgcms.adoc#_rgcms_classes_value-types_Blob[`Blob`]
or xref:rgcms.adoc#_rgcms_classes_value-types_Clob[`Clob`] parameters, indicating the type of file to accept when
uploading a new value. The attribute is also supported on xref:rgant.adoc#_rgant-Parameter_fileAccept[parameters].
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgant-Property_optionality.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgant-Property_optionality.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgant-Property_optionality.adoc
index 5aeb842..0d69502 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgant-Property_optionality.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgant-Property_optionality.adoc
@@ -129,6 +129,6 @@ public class Customer {
[NOTE]
====
-It is also possible to specify optionality using xref:rgant.adoc#_rgant_Nullable[`@Nullable`] annotation (`1.13.0-SNAPSHOT`).
+It is also possible to specify optionality using xref:rgant.adoc#_rgant_Nullable[`@Nullable`] annotation.
====
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgant-Property_publishing.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgant-Property_publishing.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgant-Property_publishing.adoc
index b215956..acc1427 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgant-Property_publishing.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgant-Property_publishing.adoc
@@ -1,5 +1,5 @@
[[_rgant-Property_publishing]]
-= `publishing()` (`1.13.0-SNAPSHOT`)
+= `publishing()`
: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/
@@ -9,7 +9,7 @@
The `publishing()` attribute determines whether and how a property edit is published via the registered implementation
of a xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`PublishingService`]) or
-xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`] (`1.13.0-SNAPSHOT`). This attribute is also supported
+xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`]. This attribute is also supported
for xref:rgant.adoc#_rgant-DomainObject_publishing[domain objects], where it controls whether changed objects are
published as events, and for xref:rgant.adoc#_rgant_Property_publishing[`@Property#publishing()`], where it controls
whether property edits are published as events.
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgant_aaa_jee.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgant_aaa_jee.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgant_aaa_jee.adoc
index a1aaff2..a9e6f39 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgant_aaa_jee.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgant_aaa_jee.adoc
@@ -33,7 +33,7 @@ The table below lists the JEE annotations currently recognized. Expect to see m
|xref:rgant.adoc#_rgant-Digits[`@javax.annotation.` +
`Nullable`]
-|(`1.13.0-SNAPSHOT` Specify that a property/parameter is optional.
+|Specify that a property/parameter is optional.
|Domain
|
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgcfg_configuring-core.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgcfg_configuring-core.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgcfg_configuring-core.adoc
index e65b346..bdc1a3d 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgcfg_configuring-core.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgcfg_configuring-core.adoc
@@ -194,11 +194,10 @@ This property is IGNORED if the xref:rgcfg.adoc#_rgcfg_configuring-components[`i
`applicationFeatures.init`
| `lazy`, `eager` +
(`lazy`)
-|(`1.13.0-SNAPSHOT`) Whether the application features repository (which surfaces the framework's metamodel) should be
+|Whether the application features repository (which surfaces the framework's metamodel) should be
initialized lazily or eagerly. +
-Lazy initialization can speed up bootstrapping, useful while developing and running tests. The default prior to
-`1.13.0` was eager initialization.
+Lazy initialization can speed up bootstrapping, useful while developing and running tests. The default prior to `1.13.0` was eager initialization.
|`isis.services.` +
@@ -218,7 +217,7 @@ Lazy initialization can speed up bootstrapping, useful while developing and runn
|`isis.services.` +
`command.properties`
| `all`, `none` (`all`)
-|(`1.13.0-SNAPSHOT`) Whether property edits should be automatically reified into commands (for properties annotated with xref:rgant.adoc#_rgant-Property_command[`@Property(command=CommandReification.AS_CONFIGURED)`]. +
+|(Whether property edits should be automatically reified into commands (for properties annotated with xref:rgant.adoc#_rgant-Property_command[`@Property(command=CommandReification.AS_CONFIGURED)`]. +
|`isis.services.` +
@@ -317,7 +316,7 @@ This implementation provides a default set of recognizers to convert RDBMS const
`injector.injectPrefix`
| `true`,`false` +
(`false`)
-|(`1.13.0-SNAPSHOT`) Whether the framework should support `inject...()` as a prefix for injecting domain services into other domain objects.
+|(Whether the framework should support `inject...()` as a prefix for injecting domain services into other domain objects.
+
By default this is disabled. The default prior to `1.13.0` was enabled. If the setting is left as disabled then this may reduce application start-up times.
@@ -326,7 +325,7 @@ By default this is disabled. The default prior to `1.13.0` was enabled. If the
`injector.setPrefix`
| `true`,`false` +
(`true`)
-|(`1.13.0-SNAPSHOT`) Whether the framework should support `set...()` as a prefix for injecting domain services into other domain objects.
+|Whether the framework should support `set...()` as a prefix for injecting domain services into other domain objects.
+
By default this is enabled (no change in `1.13.0`). If the setting is changed to disabled then this may reduce application start-up times.
@@ -348,7 +347,7 @@ By default this is enabled (no change in `1.13.0`). If the setting is changed t
|`isis.services.` +
`publish.properties`
| `all`, `none` (`none`)
-|(`1.13.0-SNAPSHOT`) Whether properties should be automatically published (for properties annotated with xref:rgant.adoc#_rgant-Action_publishing[`@Property(publishing=Publishing.AS_CONFIGURED)`]. +
+|Whether properties should be automatically published (for properties annotated with xref:rgant.adoc#_rgant-Action_publishing[`@Property(publishing=Publishing.AS_CONFIGURED)`]. +
|`isis.services.` +
@@ -425,11 +424,10 @@ See xref:rgcfg.adoc#_rgcfg_configuring-core_filterVisibility[section below] for
|`isis.reflector.facets`
|`FQCN`
-|Fully qualified class names of a custom implementation of `ProgrammingModel` interface. +
-
-See xref:ugbtb.adoc#_ugbtb_programming-model_finetuning[finetuning the programming model] for more details.
+|This property is now ignored. +
++
+To customize the programming model, use `facets.exclude` and `facets.include`. See xref:ugbtb.adoc#_ugbtb_programming-model_finetuning[finetuning the programming model] for more details.
-`1.13.0-SNAPSHOT` - this property is now ignored. To customize the programming model, use `facets.exclude` and `facets.include`.
@@ -446,7 +444,7 @@ See xref:ugbtb.adoc#_ugbtb_programming-model_finetuning[finetuning the programmi
`ignoreDeprecated`
|`true`,`false` +
(`false`)
-|(`1.13.0-SNAPSHOT`) whether deprecated facets should be ignored or honoured. +
+|Whether deprecated facets should be ignored or honoured. +
+
By default all deprecated facets are honoured; they remain part of the metamodel. If instead this property is set to
`true` then the facets are simply not loaded into the metamodel and their semantics will be excluded. +
@@ -485,7 +483,7 @@ See xref:ugbtb.adoc#_ugbtb_programming-model_custom-validator[Custom Validator]
(`true`)
| Whether deprecated annotations or naming conventions are tolerated or not. If not, then a metamodel validation error will be triggered, meaning the app won't boot (fail-fast). +
+
-See also `isis.reflector.facets.ignoreDeprecated` (`1.13.0-SNAPSHOT`).
+See also `isis.reflector.facets.ignoreDeprecated`.
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgcfg_specifying-components.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgcfg_specifying-components.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgcfg_specifying-components.adoc
index 36963b3..7507774 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgcfg_specifying-components.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgcfg_specifying-components.adoc
@@ -98,15 +98,7 @@ If the `AppManifest` is _not_ being used then there are number of other configur
== Viewer Configuration
-Viewers are specified by way of the filters and servlets in the xref:ugbtb.adoc#_ugbtb_web-xml[`web.xml`] file; these are not bootstrapped by the framework, rather it is the other way around. However, we can also hint to the framework as to which viewers are in use by way of a context parameter:
+Viewers are specified by way of the filters and servlets in the xref:ugbtb.adoc#_ugbtb_web-xml[`web.xml`] file; these are not bootstrapped by the framework, rather it is the other way around.
-[source,xml]
-----
-<context-param>
- <param-name>isis.viewers</param-name>
- <param-value>wicket,restfulobjects</param-value>
-</context-param>
-----
-
-As of `1.13.0-SNAPSHOT`, this configuration property has no effect: the `viewer_wicket.properties` and `viewer_restulobjects.properties` are always checked. In previous versions, this context param was used to indicate which of the two config files should be read.
+In versions prior to `1.13.0`, the "isis.viewers" context parameter was used to hint which configuration files should be read (corresponding to the viewers in use). As of `1.13.0`, however, the configuration property has no effect: the `viewer_wicket.properties` and `viewer_restulobjects.properties` are always loaded if available.
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgcms_classes_contributee_HasTransactionId.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgcms_classes_contributee_HasTransactionId.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgcms_classes_contributee_HasTransactionId.adoc
index c6d8484..407200c 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgcms_classes_contributee_HasTransactionId.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgcms_classes_contributee_HasTransactionId.adoc
@@ -25,7 +25,7 @@ public interface HasTransactionId {
public void setTransactionId(final UUID transactionId);
}
----
-<1> unique identifier (a GUID) of this request/interaction (`1.13.0-SNAPSHOT`).
+<1> unique identifier (a GUID) of this request/interaction.
Modules that either have domain entity that implement and/or services that contribute this interface are:
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgcms_classes_domainevent_ActionDomainEvent.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgcms_classes_domainevent_ActionDomainEvent.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgcms_classes_domainevent_ActionDomainEvent.adoc
index 3c3c6d6..8ed8a13 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgcms_classes_domainevent_ActionDomainEvent.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgcms_classes_domainevent_ActionDomainEvent.adoc
@@ -49,7 +49,7 @@ annotation attribute. Whether this raises an event or not depends upon the
`isis.reflector.facet.actionAnnotation.domainEvent.postForDefault` configuration property.
<2> The `Noop` class is provided as a convenience to indicate that an event should _not_ be posted (irrespective of the configuration property setting).
<3> Similarly, the `Doop` class is provided as a convenience to indicate that an event _should_ be raised (irrespective of the configuration property setting).
-<4> Deprecated, use xref:rgsvc.adoc#_rgsvc_api_CommandContext[`CommandContext`] or (better) xref:rgsvc.adoc#_rgsvc_api_InteractionContext[`InteractionContext`] (`1.13.0-SNAPSHOT`) instead.
-<5> (`1.13.0-SNAPSHOT`) Populated only for mixins; holds the underlying domain object that the mixin contributes to.
+<4> Deprecated, use xref:rgsvc.adoc#_rgsvc_api_CommandContext[`CommandContext`] or (better) xref:rgsvc.adoc#_rgsvc_api_InteractionContext[`InteractionContext`]instead.
+<5> Populated only for mixins; holds the underlying domain object that the mixin contributes to.
<6> The arguments being used to invoke the action; populated during validate phase and subsequent phases.
<7> The value returned by the action; populated only in the executed phase.
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-aim.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-aim.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-aim.adoc
index cc1eaf3..7aeef8f 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-aim.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-aim.adoc
@@ -10,11 +10,11 @@ The "aim" schema defines the serialized form (or memento) of an action invocatio
[WARNING]
====
-This schema has been removed in `1.13.0-SNAPSHOT`, replaced with xref:rgcms.adoc#_rgcms_schema-ixn[ixn.xsd] (for action
+This schema has been removed in `1.13.0`, replaced with xref:rgcms.adoc#_rgcms_schema-ixn[ixn.xsd] (for action
invocations/property edits) and with xref:rgcms.adoc#_rgcms_schema-cmd[cmd.xsd] (commands, ie the __intention__ to
invoke an action/edit a property).
-The remaining content on this page describes how `CommandContext` works up to v1.12.x. However, as of `1.13.0-SNAPSHOT` the `CommandContext` uses its own `cmd.xsd` schema).
+The remaining content on this page describes how `CommandContext` works up to v1.12.x. However, as of `1.13.0` the `CommandContext` uses its own `cmd.xsd` schema).
====
Action invocations are captured (in memory rather than in serialized form) when the end-user invokes the action
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-chg.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-chg.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-chg.adoc
index 7584b59..17f3ac1 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-chg.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-chg.adoc
@@ -1,12 +1,12 @@
[[_rgcms_schema-chg]]
-= Changes (`1.13.0-SNAPSHOT`)
+= Changes
: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 changes ("chg") schema (`1.13.0-SNAPSHOT`) defines the serialized form identifying which objects have been created,
+The changes ("chg") schema defines the serialized form identifying which objects have been created,
updated or deleted as the result of invoking an action or editing a property. It also captures a number of other
metrics counts (number of objects loaded, number of object properties modified), useful for profiling.
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-cmd.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-cmd.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-cmd.adoc
index 8b9c720..c2ca7d5 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-cmd.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-cmd.adoc
@@ -1,12 +1,12 @@
[[_rgcms_schema-cmd]]
-= Command (`1.13.0-SNAPSHOT`)
+= Command
: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 command ("cmd") schema (`1.13.0-SNAPSHOT`) defines the serialized form of the __intention__ to invoke an action or to
+The command ("cmd") schema defines the serialized form of the __intention__ to invoke an action or to
edit a property.
[NOTE]
@@ -58,7 +58,7 @@ URLs, you will find that the schemas are also downloadable from this location.
to the xref:rgcms.adoc#_rgcms_schema_interaction[interaction] that executes the command, and to any
xref:rgcms.adoc#_rgcms_schema_changes[changes] to domain objects occurring as a side-effect of that interaction.
<6> the name of the user who created the command (whose intention it is to invoke the action/edit the property).
-<7> the target object (or objects) to be invoked. As of `1.13.0-SNAPSHOT`, a bulk action will create multiple commands,
+<7> the target object (or objects) to be invoked. As of `1.13.0`, a bulk action will create multiple commands,
each with only a single target, but a future version of the framework may also support a single bulk command against
this multiple targets (ie all-or-nothing).
<8> the `memberDto`, defined below, the captures the action/property and arguments/new value.
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-common.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-common.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-common.adoc
index 6e51021..6e3e352 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-common.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-common.adoc
@@ -61,12 +61,12 @@ attributes), or to the (JDO) xref:rgant.adoc#_rgant-Discriminator[`@Discriminato
is specified, then the fully qualified class name will be used.
<4> the object identifier (aka primary key), converted to string form.
<5> the `bookmarkObjectState` enumerates the possible persistence states of the referenced object. In previous versions
-of the schema the attribute was defaulted to "persistent"; as of `1.13.0-SNAPSHOT` the "persistent" state is assumed
-of the attribute is omitted.
+of the schema the attribute was defaulted to "persistent"; the "persistent" state is assumed
+if the attribute is omitted.
<6> Models a list of OIDs. This is used by the xref:rgcms.adoc#_rgcms_schema_cmd["cmd" schema] to represent the
intention to perform a bulk actions (against a number of selected objects).
-In previous versions of the schema (prior to `1.13.0-SNAPSHOT`) the object type and object identifers of `oidDto` were
+In previous versions of the schema the object type and object identifers of `oidDto` were
modelled as an element rather than an attribute. The element form can still be used, but is deprecated.
The `oidDto` complex type is used in a number of places by the framework:
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-ixn.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-ixn.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-ixn.adoc
index 39b0ea3..da77934 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-ixn.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema-ixn.adoc
@@ -1,12 +1,12 @@
[[_rgcms_schema-ixn]]
-= Interaction Execution (`1.13.0-SNAPSHOT`)
+= Interaction Execution
: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 interaction ("ixn") schema (`1.13.0-SNAPSHOT`) defines the serialized form of an action invocation or a property
+The interaction ("ixn") schema defines the serialized form of an action invocation or a property
edit. In fact, it actually defines a call-graph of such executions for those cases where the
xref:rgsvc.adoc#_rgsvc_api_WrapperFactory[`WrapperFactory`] is used to execute sub-actions/property edits.
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema.adoc
index f3eef8c..5a84631 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgcms_schema.adoc
@@ -9,21 +9,21 @@ Most applications need to integrate with other apps in the enterprise. To facil
Apache Isis defines a number of standard XSD schemas:
-* the xref:rgcms.adoc#_rgcms_schema-cmd[command] schema (`1.13.0-SNAPSHOT`), which captures the __intention__ of a user
+* the xref:rgcms.adoc#_rgcms_schema-cmd[command] schema, which captures the __intention__ of a user
to invoke an action or edit a property
-* the xref:rgcms.adoc#_rgcms_schema-ixn[interaction execution] schema (`1.13.0-SNAPSHOT`), which captures the actual execution of an action invocation/property edit
+* the xref:rgcms.adoc#_rgcms_schema-ixn[interaction execution] schema, which captures the actual execution of an action invocation/property edit
-* the xref:rgcms.adoc#_rgcms_schema-chg[changes] schema (`1.13.0-SNAPSHOT`), which captures which objects have been
+* the xref:rgcms.adoc#_rgcms_schema-chg[changes] schema, which captures which objects have been
created, updated or deleted as the result of an execution of an action invocation/property edit
-* the xref:rgcms.adoc#_rgcms_schema-aim[action memento invocation] schema (deprecated in `1.13.0-SNAPSHOT`, replaced by
+* the xref:rgcms.adoc#_rgcms_schema-aim[action memento invocation] schema (deprecated in `1.13.0`, replaced by
either "cmd" or "ixn"), which allows action invocations to be captured and reified.
These each use XSD types defined by the xref:rgcms.adoc#_rgcms_schema-common[common schema] (most notably the `oidDto`
complex type which identifies a domain object).
-(As of `1.13.0-SNAPSHOT`) the (non-ASF) http://github.com/isisaddons/isis-module-command[Isis addons' command] and
+The (non-ASF) http://github.com/isisaddons/isis-module-command[Isis addons' command] and
http://github.com/isisaddons/isis-module-publishmq[Isis addons' publishmq] modules uses these schemas to reify
corresponding applib objects (`Command`, `Interaction.Execution` and `PublishedObjects`), either to persist or
publishing using an link:http://activemq.apache.org[Apache ActiveMQ] message queue.
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgfis_application-layer.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgfis_application-layer.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgfis_application-layer.adoc
index eeaaa77..00585c5 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgfis_application-layer.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgfis_application-layer.adoc
@@ -28,7 +28,7 @@ Impl'n (g: a:)
|xref:rgfis.adoc#_rgfis_spi_CommandDtoServiceInternal[`o.a.i.c.m.s.command` +
`CommandDtoServiceInternal`]
-|(`1.13.0-SNAPSHOT`) Creates memento of current action invocation, for use as a serializable XML reified command. The
+|Creates memento of current action invocation, for use as a serializable XML reified command. The
most notable usage of this is to allow the execution of the `Command` to be deferred to run in the background (via
xref:rgant.adoc#_rgant-Action_command[`@Action#commandExecuteIn()`] or
xref:rgant.adoc#_rgant-Property_command[`@Property#commandExecuteIn()`].
@@ -41,7 +41,7 @@ xref:rgant.adoc#_rgant-Property_command[`@Property#commandExecuteIn()`].
|xref:rgfis.adoc#_rgfis_spi_InteractionDtoServiceInternal[`o.a.i.c.m.s.ixn` +
`InteractionDtoServiceInternal`]
-|(`1.13.0-SNAPSHOT`) Creates DTO for the current execution of an action invocation or property edit, for use either as a reified command or for implementations of the xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`PublishingService`].
+|Creates DTO for the current execution of an action invocation or property edit, for use either as a reified command or for implementations of the xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`PublishingService`].
|`CommandDtoService-` +
`InternalServiceDefault` +
``o.a.i.c.m.s.command`` +
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgfis_persistence-layer.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgfis_persistence-layer.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgfis_persistence-layer.adoc
index f1e0af9..4a6b665 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgfis_persistence-layer.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgfis_persistence-layer.adoc
@@ -29,23 +29,23 @@ Impl'n (g: a:)
|xref:rgfis.adoc#_rgfis_spi_AuditingServiceInternal[`o.a.i.c.r.s.auditing.` +
`AuditingServiceInternal`]
-|(`1.13.0-SNAPSHOT`) Co-ordinates between
+|Co-ordinates between
xref:rgfis.adoc#_rgfis_spi_ChangedObjectsServiceInternal[`ChangedObjectsServiceInternal`] and
-xref:rgfis.adoc#_rgfis_spi_AuditingService[`AuditingService`].
+xref:rgfis.adoc#_rgfis_spi_AuditerService[`AuditerService`].
|concrete class.
|
|xref:rgfis.adoc#_rgfis_spi_ChangedObjectsServiceInternal[`o.a.i.c.r.s.changes.` +
`ChangedObjectsServiceInternal`]
-|(`1.13.0-SNAPSHOT`) Request-scoped service holding objects enlisted into current transaction.
+|Request-scoped service holding objects enlisted into current transaction.
|concrete class.
|
|xref:rgfis.adoc#_rgfis_spi_PublishingServiceInternal[`o.a.i.c.m.s.publishing.` +
`PublishingServiceInternal`]
-|(`1.13.0-SNAPSHOT`) Co-ordinates between
+|Co-ordinates between
xref:rgfis.adoc#_rgfis_spi_ChangedObjectsServiceInternal[`ChangedObjectsServiceInternal`] and
xref:rgsvc.adoc#_rgsvc_api_MetricsService[`MetricsService`] and the SPI services,
xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`] and (deprecated)
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_AuditingServiceInternal.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_AuditingServiceInternal.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_AuditingServiceInternal.adoc
index 8f2a355..f792fe1 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_AuditingServiceInternal.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_AuditingServiceInternal.adoc
@@ -1,11 +1,11 @@
[[_rgfis_spi_AuditingServiceInternal]]
-= `AuditingServiceInternal` (`1.13.0-SNAPSHOT`)
+= `AuditingServiceInternal`
: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 (internal) `AuditingServiceInternal` domain service (`1.13.0-SNAPSHOT`) acts as an internal facade to any
+The (internal) `AuditingServiceInternal` domain service acts as an internal facade to any
configured xref:rgsvc.adoc#_rgsvc_spi_AuditingService[`AuditingService`] and
xref:rgsvc.adoc#_rgsvc_spi_AuditerService[`AuditerService`] services. It is responsible for obtaining the details
of all changes to domain objects within an interaction, and then to call the configured `AuditingService` to actually
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_ChangedObjectsServiceInternal.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_ChangedObjectsServiceInternal.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_ChangedObjectsServiceInternal.adoc
index 534a2a9..2fbd98b 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_ChangedObjectsServiceInternal.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_ChangedObjectsServiceInternal.adoc
@@ -1,11 +1,11 @@
[[_rgfis_spi_ChangedObjectsServiceInternal]]
-= `ChangedObjectsServiceInternal` (`1.13.0-SNAPSHOT`)
+= `ChangedObjectsServiceInternal`
: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 `ChangedObjectsServiceInternal` class (`1.13.0-SNAPSHOT`) is an (internal) request-scoped domain service that is
+The `ChangedObjectsServiceInternal` class is an (internal) request-scoped domain service that is
responsible for collecting the details of all changes to domain objects within an interaction. This is then used by
various other (internal) domain services, notably
xref:rgfis.adoc#_rgfis_spi_AuditingServiceInternal[`AuditingServiceInternal`] and
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_CommandDtoServiceInternal.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_CommandDtoServiceInternal.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_CommandDtoServiceInternal.adoc
index 7561c57..c9ae7c3 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_CommandDtoServiceInternal.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_CommandDtoServiceInternal.adoc
@@ -1,11 +1,11 @@
[[_rgfis_spi_CommandDtoServiceInternal]]
-= `CommandDtoServiceInternal` (`1.13.0-SNAPSHOT`)
+= `CommandDtoServiceInternal`
: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 `CommandDtoServiceInternal` (`1.13.0-SNAPSHOT`) is responsible for creating an memento of the current action
+The `CommandDtoServiceInternal` is responsible for creating an memento of the current action
invocation or property edit, to store in the `Command` object (from
xref:rgsvc.adoc#_rgsvc_api_CommandContext[`CommandContext`]). This memento is a JAXB DTO being an instance of the
xref:rgcms.adoc#_rgcms_schema-cmd["cmd" schema], so can be reified so that its execution can be deferred until later,
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_InteractionDtoServiceInternal.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_InteractionDtoServiceInternal.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_InteractionDtoServiceInternal.adoc
index 39191e2..643514a 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_InteractionDtoServiceInternal.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_InteractionDtoServiceInternal.adoc
@@ -1,12 +1,12 @@
[[_rgfis_spi_InteractionDtoServiceInternal]]
-= `InteractionDtoServiceInternal` (`1.13.0-SNAPSHOT`)
+= `InteractionDtoServiceInternal`
: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 `InteractionDtoServiceInternal` internal domain service (`1.13.0-SNAPSHOT`) is used by the framework to create and update DTOs representing member executions, ie the invocation of an action or the editing of a property. The DTO is in all cases a subclass of `MemberExecutionDto`, from the xref:rgcms.adoc#_rgcms_schema-ixn["ixn" schema], and subsequently accessible from the `Interaction` object (per the xref:rgsvc.adoc#_rgsvc_api_InteractionContext[`InteractionContext`] service).
+The `InteractionDtoServiceInternal` internal domain service is used by the framework to create and update DTOs representing member executions, ie the invocation of an action or the editing of a property. The DTO is in all cases a subclass of `MemberExecutionDto`, from the xref:rgcms.adoc#_rgcms_schema-ixn["ixn" schema], and subsequently accessible from the `Interaction` object (per the xref:rgsvc.adoc#_rgsvc_api_InteractionContext[`InteractionContext`] service).
== SPI & Implementation
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_PublishingServiceInternal.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_PublishingServiceInternal.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_PublishingServiceInternal.adoc
index 0d45234..9dd56aa 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_PublishingServiceInternal.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgfis_spi_PublishingServiceInternal.adoc
@@ -1,12 +1,12 @@
[[_rgfis_spi_PublishingServiceInternal]]
-= `PublishingServiceInternal` (`1.13.0-SNAPSHOT`)
+= `PublishingServiceInternal`
: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 (internal) `PublishingServiceInternal` domain service (`1.13.0-SNAPSHOT`) acts as an internal facade to any
-configured xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`] or (deprecated in `1.13.0-SNAPSHOT`)
+The (internal) `PublishingServiceInternal` domain service acts as an internal facade to any
+configured xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`] or (deprecated)
xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`PublishingService`] domain services.
For published action invocations/ property edits, it provides an API for those member executions to call.
@@ -43,7 +43,7 @@ xref:rgant.adoc#_rgant-Action_publishing[`@Action#publishing()`] annotation attr
xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`]. The `Execution` object will be an instance of
`ActionInvocation` (see xref:rgsvc.adoc#_rgsvc_api_InteractionContext[`InteractionContext`] for details).
<2> the remaining parameters are to support the publishing of the action to any configured
-xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`PublishingService`] services (deprecated in `1.13.0-SNAPSHOT`).
+xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`PublishingService`] services (deprecated).
<3> to publish a property edit, as as represented by the specified member `Execution` parameter and with the
xref:rgant.adoc#_rgant-Property_publishing[`@Property#publishing()`] annotation attribute or equivalent, to any
configured xref:rgsvc.adoc#_rgsvc_spi_PublisherService[`PublisherService`]. The `Execution` object will be an instance
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgmvn_validate.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgmvn_validate.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgmvn_validate.adoc
index 56a92f6..84c26ae 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgmvn_validate.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgmvn_validate.adoc
@@ -151,7 +151,7 @@ Running `mvn test` then generates this output:
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] ...
-[ERROR] Failed to execute goal org.apache.isis.tool:isis-maven-plugin:1.13.0-SNAPSHOT:validate (default) on project simpleapp-dom: 1 problems found. -> [Help 1]
+[ERROR] Failed to execute goal org.apache.isis.tool:isis-maven-plugin:1.13.0:validate (default) on project simpleapp-dom: 1 problems found. -> [Help 1]
----
If one were to attempt to run the application, the same error would appear in the log files on startup (and the application would not boot).
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgmvn_xsd.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgmvn_xsd.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgmvn_xsd.adoc
index 25cc96a..52ebb4d 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgmvn_xsd.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgmvn_xsd.adoc
@@ -76,7 +76,7 @@ First, the usual boilerplate:
<parent>
<groupId>org.isisaddons.app</groupId>
<artifactId>todoapp</artifactId>
- <version>1.13.0-SNAPSHOT</version>
+ <version>1.14.0-SNAPSHOT</version>
</parent>
<artifactId>todoapp-xsd</artifactId>
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_BackgroundService.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_BackgroundService.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_BackgroundService.adoc
index 92ec95d..a476d80 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_BackgroundService.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_BackgroundService.adoc
@@ -7,14 +7,13 @@
The `BackgroundService2` domain service, and also the companion
xref:rgsvc.adoc#_rgsvc_spi_BackgroundCommandService[`BackgroundCommandService2`] SPI service, enable commands
-to be persisted such that they may be invoked in the background. (The `BackgroundService2` and
-`BackgroundCommandService2` extensions to these services have been introduced in `1.13.0-SNAPSHOT`).
+to be persisted such that they may be invoked in the background.
The `BackgroundService2` is responsible for capturing a memento representing the command in a typesafe way,
and persisting it rather than executing it directly.
The default `BackgroundServiceDefault` implementation works by using a proxy wrapper around the target so that it can
-capture the action to invoke and its arguments. (As of `1.13.0-SNAPSHOT`), this is done using xref:rgfis.adoc#_rgfis_spi_CommandDtoServiceInternal[`CommandDtoServiceInternal`] (in previous releases it used (a private copy of) xref:rgsvc.adoc#_rgsvc_api_MementoService[`MementoService`]).
+capture the action to invoke and its arguments. (As of `1.13.0`), this is done using xref:rgfis.adoc#_rgfis_spi_CommandDtoServiceInternal[`CommandDtoServiceInternal`] (in previous releases it used (a private copy of) xref:rgsvc.adoc#_rgsvc_api_MementoService[`MementoService`]).
The persistence delegates the persistence of the memento to an appropriate implementation of the companion
`BackgroundCommandService2`. One such implementation of `BackgroundCommandService` is provided by (non-ASF)
@@ -40,7 +39,7 @@ public interface BackgroundService2 {
}
----
<1> returns a proxy around the domain object; any methods executed against this proxy will result in a command (to invoke the corresponding action) being persisted by xref:rgsvc.adoc#_rgsvc_spi_BackgroundCommandService2[`BackgroundCommandService2`]
-<2> (`1.13.0-SNAPSHOT`) returns a proxy around the mixin; any methods executed against this proxy will result in a command (to invoke the corresponding mixin action) being persisted by xref:rgsvc.adoc#_rgsvc_spi_BackgroundCommandService2[`BackgroundCommandService2`].
+<2> Returns a proxy around the mixin; any methods executed against this proxy will result in a command (to invoke the corresponding mixin action) being persisted by xref:rgsvc.adoc#_rgsvc_spi_BackgroundCommandService2[`BackgroundCommandService2`].
The default implementation is provided by core (`o.a.i.core.runtime.services.background.BackgroundServiceDefault`).
@@ -126,7 +125,7 @@ The `CommandContext` service is responsible for providing a parent `Command` wit
The implementations of `CommandService` and `BackgroundCommandService` go together; typically both parent `Command`s and child background `Command`s will be persisted in the same way. The (non-ASF) http://github.com/isisaddons/isis-module-command[Isis addons' command] module provides implementations of both (see xref:rgsvc.adoc#_rgsvc_spi_CommandService[`CommandService`] and xref:rgsvc.adoc#_rgsvc_spi_BackgroundCommandService[`BackgroundCommandService`]).
-The xref:rgfis.adoc#_rgfis_spi_CommandDtoServiceInternal[`CommandDtoServiceInternal`] (`1.13.0-SNAPSHOT`) is used to obtain
+The xref:rgfis.adoc#_rgfis_spi_CommandDtoServiceInternal[`CommandDtoServiceInternal`] is used to obtain
a memento of the command such that it can be persisted. (In earlier versions, xref:rgsvc.adoc#_rgsvc_api_MementoService[`MementoService`] was used for this purpose).
http://git-wip-us.apache.org/repos/asf/isis/blob/7f83398c/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_BookmarkService.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_BookmarkService.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_BookmarkService.adoc
index 4bbaa2c..7507024 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_BookmarkService.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_BookmarkService.adoc
@@ -24,7 +24,7 @@ For example, a `Bookmark` could be converted into a barcode, and then this used
``Bookmark``s are used by several other domain services as a means of storing areference to an arbitrary object
(a polymorphic relationship). For example, the (non-ASF)
http://github.com/isisaddons/isis-module-auditing[Isis addons' auditing] module's implementation of
-xref:rgsvc.adoc#_rgsvc_spi_AuditerService[`AuditerService`] (`1.13.0-SNAPSHOT`) uses bookmarks to capture the object
+xref:rgsvc.adoc#_rgsvc_spi_AuditerService[`AuditerService`] uses bookmarks to capture the object
that is being audited.
[TIP]
@@ -111,7 +111,7 @@ bookmark to capture the target object on which an action will be invoked subsequ
Bookmarks are also used by the (non-ASF) http://github.com/isisaddons/isis-module-publishing[Isis addons' publishing]
module's implementation of xref:rgsvc.adoc#_rgsvc_spi_PublishingService[`PublishingService`], and by the
(non-ASF) http://github.com/isisaddons/isis-module-auditing[Isis addons' auditing] module's implementation of
-xref:rgsvc.adoc#_rgsvc_spi_AuditerService[`AuditerService`] (`1.13.0-SNAPSHOT`).
+xref:rgsvc.adoc#_rgsvc_spi_AuditerService[`AuditerService`].