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 2017/08/01 15:30:34 UTC
[1/7] isis git commit: ISIS-1674: adds some missing images for new
helloworld archetype docs
Repository: isis
Updated Branches:
refs/heads/master 1c6f349ae -> dd0f05e16
ISIS-1674: adds some missing images for new helloworld archetype docs
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/4d6bcd50
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/4d6bcd50
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/4d6bcd50
Branch: refs/heads/master
Commit: 4d6bcd5064439a4ba8bfe3e639298d12932466fa
Parents: 1c6f349
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Tue Aug 1 14:03:37 2017 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Tue Aug 1 14:03:37 2017 +0100
----------------------------------------------------------------------
.../_ugfun_getting-started_helloworld-archetype.adoc | 11 +++++++++++
1 file changed, 11 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/4d6bcd50/adocs/documentation/src/main/asciidoc/guides/ugfun/_ugfun_getting-started_helloworld-archetype.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/ugfun/_ugfun_getting-started_helloworld-archetype.adoc b/adocs/documentation/src/main/asciidoc/guides/ugfun/_ugfun_getting-started_helloworld-archetype.adoc
index e61db92..c647369 100644
--- a/adocs/documentation/src/main/asciidoc/guides/ugfun/_ugfun_getting-started_helloworld-archetype.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/ugfun/_ugfun_getting-started_helloworld-archetype.adoc
@@ -22,6 +22,11 @@ This also creates a minimal application, but provides more structure and example
Create a new directory, and `cd` into that directory.
+[WARNING]
+====
+This archetype was introduced in `1.15.0-SNAPSHOT`, and has not - yet - been released.
+====
+
To build the app from the latest stable release, then run the following command:
[source,bash]
@@ -228,6 +233,12 @@ image::{_imagesdir}getting-started/using-hello-world/080-edit-notes.png[width="6
It's also possible to delete an object:
+image::{_imagesdir}getting-started/using-hello-world/090-delete-object.png[width="600px",link="{_imagesdir}getting-started/using-hello-world/090-delete-object.png"]
+
+The viewer displays a message confirming that the object has been deleted:
+
+
+image::{_imagesdir}getting-started/using-hello-world/100-object-deleted.png[width="600px",link="{_imagesdir}getting-started/using-hello-world/100-object-deleted.png"]
The above functionality is implemented by link:https://github.com/apache/isis/blob/master/example/application/helloworld/src/main/java/domainapp/dom/impl/HelloWorldObject.java#L87[this code]:
[5/7] isis git commit: ISIS-1521: fixes bad links
Posted by da...@apache.org.
ISIS-1521: fixes bad links
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/91b9cb82
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/91b9cb82
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/91b9cb82
Branch: refs/heads/master
Commit: 91b9cb829e9e1975599e70a808b8f2575ef3bc1f
Parents: 18557ba
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Tue Aug 1 16:21:15 2017 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Tue Aug 1 16:21:15 2017 +0100
----------------------------------------------------------------------
.../asciidoc/guides/cgcom/_cgcom_post-release-successful.adoc | 2 +-
.../src/main/asciidoc/guides/dg/_dg_asciidoc-syntax.adoc | 4 ++--
.../src/main/asciidoc/pages/screencasts/screencasts-older.adoc | 2 +-
3 files changed, 4 insertions(+), 4 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/91b9cb82/adocs/documentation/src/main/asciidoc/guides/cgcom/_cgcom_post-release-successful.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/cgcom/_cgcom_post-release-successful.adoc b/adocs/documentation/src/main/asciidoc/guides/cgcom/_cgcom_post-release-successful.adoc
index 6321b97..20255ad 100644
--- a/adocs/documentation/src/main/asciidoc/guides/cgcom/_cgcom_post-release-successful.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/cgcom/_cgcom_post-release-successful.adoc
@@ -427,7 +427,7 @@ For these artifacts you will need to search http://search.maven.org[Maven centra
== Code formatting
This is also a good time to make source code has been cleaned up and formatted according to the Apache Isis and ASF conventions.
-Use link:../dg/resources/eclipse/templates/Apache-code-style-formatting.xml[this] Eclipse template and link:../dg/resources/eclipse/isis.importorder[this] import order.
+Use link:../dg/resources/eclipse/Apache-code-style-formatting.xml[this] Eclipse template and link:../dg/resources/eclipse/isis.importorder[this] import order.
http://git-wip-us.apache.org/repos/asf/isis/blob/91b9cb82/adocs/documentation/src/main/asciidoc/guides/dg/_dg_asciidoc-syntax.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/dg/_dg_asciidoc-syntax.adoc b/adocs/documentation/src/main/asciidoc/guides/dg/_dg_asciidoc-syntax.adoc
index cdbaa7c..97da93f 100644
--- a/adocs/documentation/src/main/asciidoc/guides/dg/_dg_asciidoc-syntax.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/dg/_dg_asciidoc-syntax.adoc
@@ -237,9 +237,9 @@ link:http://ciserver:8080[CI Server^]
|Link to an external hyperlink, with `target=blank`
|....
-xref:_markup-docs_background.adoc#[background]
+xref:dg.adoc#__dg_asciidoc_links-and-xrefs#[background]
....
-|xref:_markup-docs_background.adoc#[background]
+|xref:dg.adoc#__dg_asciidoc_links-and-xrefs[background]
|Cross-reference to section in same asciidoc document
|....
http://git-wip-us.apache.org/repos/asf/isis/blob/91b9cb82/adocs/documentation/src/main/asciidoc/pages/screencasts/screencasts-older.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/pages/screencasts/screencasts-older.adoc b/adocs/documentation/src/main/asciidoc/pages/screencasts/screencasts-older.adoc
index e86f139..7686a68 100644
--- a/adocs/documentation/src/main/asciidoc/pages/screencasts/screencasts-older.adoc
+++ b/adocs/documentation/src/main/asciidoc/pages/screencasts/screencasts-older.adoc
@@ -63,7 +63,7 @@ Learn more xref:../../guides/dg/dg.adoc#[here]
_How to import an Apache Isis maven-based application into IntelliJ and run the app._ +
-Learn more link:./guides/dg/dg.html#_dg_ide_intellij[here]
+Learn more xref:../../guides/dg/dg.adoc#_dg_ide_intellij[here]
|video::lwKsyTbTSnA[youtube,width="420px",height="315px"]
[3/7] isis git commit: ISIS-1685: adds missing package-info.java for
applib
Posted by da...@apache.org.
ISIS-1685: adds missing package-info.java for applib
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/6c1d8b8b
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/6c1d8b8b
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/6c1d8b8b
Branch: refs/heads/master
Commit: 6c1d8b8b1d209fc81079425853f169431dfdf8d3
Parents: 4d6bcd5
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Tue Aug 1 16:20:14 2017 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Tue Aug 1 16:20:14 2017 +0100
----------------------------------------------------------------------
.../asciidoc/guides/rgmvn/_rgmvn_intro.adoc | 2 +-
.../asciidoc/guides/rgmvn/_rgmvn_swagger.adoc | 2 +-
...vc_application-layer-api_WrapperFactory.adoc | 2 +-
...bootstrapping-spi_ClassDiscoveryService.adoc | 4 +--
.../_rgsvc_metadata-api_ServiceRegistry.adoc | 2 +-
.../_rgsvc_metadata-api_SwaggerService.adoc | 2 +-
...ntation-layer-spi_ContentMappingService.adoc | 5 +--
...ntation-layer-spi_ErrorReportingService.adoc | 32 +++++++++--------
.../ugsec/_ugsec_usage-by-isis-viewers.adoc | 2 +-
..._fixture-scripts-specification-provider.adoc | 2 +-
.../isis/applib/adapters/package-info.java | 14 ++++++--
.../isis/applib/annotation/package-info.java | 23 +++++++++++++
.../apache/isis/applib/conmap/package-info.java | 27 +++++++++++++++
.../apache/isis/applib/events/package-info.java | 12 +++----
.../apache/isis/applib/filter/package-info.java | 3 ++
.../isis/applib/fixtures/package-info.java | 6 ++++
.../applib/fixturescripts/package-info.java | 26 ++++++++++++++
.../applib/layout/component/package-info.java | 16 ---------
.../apache/isis/applib/layout/package-info.java | 25 ++++++++++++++
.../isis/applib/profiles/package-info.java | 36 --------------------
.../apache/isis/applib/query/package-info.java | 4 +--
.../services/acceptheader/package-info.java | 30 ++++++++++++++++
.../applib/services/actinvoc/package-info.java | 31 +++++++++++++++++
.../applib/services/appfeat/package-info.java | 27 +++++++++++++++
.../applib/services/audit/package-info.java | 26 ++++++++++++++
.../services/background/package-info.java | 27 +++++++++++++++
.../applib/services/bookmark/package-info.java | 27 +++++++++++++++
.../services/classdiscovery/package-info.java | 27 +++++++++++++++
.../applib/services/clock/package-info.java | 25 ++++++++++++++
.../applib/services/command/package-info.java | 27 +++++++++++++++
.../applib/services/config/package-info.java | 26 ++++++++++++++
.../isis/applib/services/dto/package-info.java | 28 +++++++++++++++
.../applib/services/email/package-info.java | 26 ++++++++++++++
.../applib/services/error/package-info.java | 28 +++++++++++++++
.../applib/services/eventbus/package-info.java | 26 ++++++++++++++
.../services/exceprecog/package-info.java | 28 +++++++++++++++
.../applib/services/factory/package-info.java | 26 ++++++++++++++
.../services/fixturespec/package-info.java | 28 +++++++++++++++
.../isis/applib/services/grid/package-info.java | 26 ++++++++++++++
.../applib/services/guice/package-info.java | 26 ++++++++++++++
.../isis/applib/services/hint/package-info.java | 28 +++++++++++++++
.../applib/services/homepage/package-info.java | 26 ++++++++++++++
.../applib/services/hsqldb/package-info.java | 28 +++++++++++++++
.../isis/applib/services/i18n/package-info.java | 24 +++++++++++++
.../applib/services/iactn/package-info.java | 29 ++++++++++++++++
.../isis/applib/services/jaxb/JaxbService.java | 1 -
.../isis/applib/services/jaxb/package-info.java | 26 ++++++++++++++
.../services/jdosupport/package-info.java | 29 ++++++++++++++++
.../applib/services/layout/package-info.java | 27 +++++++++++++++
.../applib/services/linking/package-info.java | 26 ++++++++++++++
.../applib/services/memento/package-info.java | 30 ++++++++++++++++
.../applib/services/message/package-info.java | 26 ++++++++++++++
.../applib/services/metamodel/package-info.java | 26 ++++++++++++++
.../applib/services/metrics/package-info.java | 27 +++++++++++++++
.../isis/applib/services/package-info.java | 24 +++++++++++++
.../applib/services/publish/package-info.java | 28 +++++++++++++++
.../queryresultscache/package-info.java | 27 +++++++++++++++
.../applib/services/registry/package-info.java | 27 +++++++++++++++
.../services/repository/package-info.java | 27 +++++++++++++++
.../applib/services/routing/package-info.java | 26 ++++++++++++++
.../services/scratchpad/package-info.java | 26 ++++++++++++++
.../applib/services/session/package-info.java | 24 +++++++++++++
.../applib/services/sessmgmt/package-info.java | 28 +++++++++++++++
.../applib/services/settings/package-info.java | 24 +++++++++++++
.../isis/applib/services/sudo/package-info.java | 29 ++++++++++++++++
.../applib/services/swagger/package-info.java | 26 ++++++++++++++
.../applib/services/tablecol/package-info.java | 26 ++++++++++++++
.../applib/services/timestamp/package-info.java | 25 ++++++++++++++
.../applib/services/title/package-info.java | 25 ++++++++++++++
.../services/urlencoding/package-info.java | 29 ++++++++++++++++
.../isis/applib/services/user/package-info.java | 25 ++++++++++++++
.../applib/services/userprof/package-info.java | 28 +++++++++++++++
.../applib/services/userreg/package-info.java | 27 +++++++++++++++
.../applib/services/wrapper/package-info.java | 28 +++++++++++++++
.../applib/services/xactn/package-info.java | 26 ++++++++++++++
.../services/xmlsnapshot/package-info.java | 26 ++++++++++++++
.../apache/isis/applib/types/package-info.java | 23 +++++++++++++
example/application/simpleapp/README.adoc | 2 +-
.../resources/archetype-resources/README.adoc | 2 +-
79 files changed, 1627 insertions(+), 96 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_intro.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_intro.adoc b/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_intro.adoc
index 8b301d6..564ffce 100644
--- a/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_intro.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_intro.adoc
@@ -81,7 +81,7 @@ We recommend the following:
* run the `validate` goal in the `dom` submodule; this will give early warning if there are any syntactic errors in the model, eg orphaned supporting methods
-* run the `swagger` goal in the `integtest` submodule; this ensures that the generated Swagger spec files correctly include any contributed actions/associations.
+* run the `swagger` goal in the `integtest` submodule; this ensures that the generated Swagger schema definition files correctly include any contributed actions/associations.
* run the `xsd` plugin in a new `xsd` submodule; contributed actions are irrelevant for this particular goal; having a separate submodule allows the configuration of both the `xsd` goal (to generate the XSD schemas) and any other XSD-related configuration to be kept in a single place.
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_swagger.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_swagger.adoc b/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_swagger.adoc
index eb00a97..bb1646c 100644
--- a/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_swagger.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_swagger.adoc
@@ -28,7 +28,7 @@ Defaults to [`PUBLIC`, `PRIVATE`] (meaning that two spec files will be created).
+
Defaults to `JSON`.
-* `output` - (optional) subdirectory under the `target` directory to generate the swagger spec files +
+* `output` - (optional) subdirectory under the `target` directory to generate the swagger schema definition files +
+
Defaults to `generated-resources/isis-swagger`
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_application-layer-api_WrapperFactory.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_application-layer-api_WrapperFactory.adoc b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_application-layer-api_WrapperFactory.adoc
index c2920c3..d07278f 100644
--- a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_application-layer-api_WrapperFactory.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_application-layer-api_WrapperFactory.adoc
@@ -7,7 +7,7 @@
-The `WrapperFactory` provides the ability to enforce business rules for programmatic interactions between domain objects. If there is a (lack-of-) trust boundary between the caller and callee -- eg if they reside in different modules -- then the wrapper factory is a useful mechanism to ensure that any business constraints defined by te callee are honoured.
+The `WrapperFactory` provides the ability to enforce business rules for programmatic interactions between domain objects. If there is a (lack-of-) trust boundary between the caller and callee -- eg if they reside in different modules -- then the wrapper factory is a useful mechanism to ensure that any business constraints defined by the callee are honoured.
For example, if the calling object attempts to modify an unmodifiable property on the target object, then an exception will be thrown. Said another way: interactions are performed "as if" they are through the viewer.
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_bootstrapping-spi_ClassDiscoveryService.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_bootstrapping-spi_ClassDiscoveryService.adoc b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_bootstrapping-spi_ClassDiscoveryService.adoc
index ee6f151..4cd5629 100644
--- a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_bootstrapping-spi_ClassDiscoveryService.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_bootstrapping-spi_ClassDiscoveryService.adoc
@@ -1,12 +1,12 @@
[[_rgsvc_bootstrapping-spi_ClassDiscoveryService]]
-= `ClassDiscoveryService`
+= `ClassDiscoveryService2`
: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 `ClassDiscovery` service is used to automatically discover subclasses of any given type on the classpath.
+The `ClassDiscoveryService2` service is used to automatically discover subclasses of any given type on the classpath.
The primary use case is to support "convention-over-configuration" designs that work with a minimum of configuration.
This service is used by the xref:../rgcms/rgcms.adoc#_rgcms_classes_super_FixtureScripts[`FixtureScripts`] service to automatically locate any xref:../rgcms/rgcms.adoc#_rgcms_classes_super_FixtureScript[`FixtureScript`] implementations.
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_metadata-api_ServiceRegistry.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_metadata-api_ServiceRegistry.adoc b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_metadata-api_ServiceRegistry.adoc
index 0c3d062..d614156 100644
--- a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_metadata-api_ServiceRegistry.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_metadata-api_ServiceRegistry.adoc
@@ -5,7 +5,7 @@
:_imagesdir: images/
-The `ServiceRegistry2` service collects together methods for accessing other domain services.
+The `ServiceRegistry2` service collects together methods for injecting or looking up domain services (either provided by the framework or application-specific) currently known to the runtime.
[NOTE]
====
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_metadata-api_SwaggerService.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_metadata-api_SwaggerService.adoc b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_metadata-api_SwaggerService.adoc
index 37d87de..5a14ede 100644
--- a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_metadata-api_SwaggerService.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_metadata-api_SwaggerService.adoc
@@ -12,7 +12,7 @@ These spec files can then be used with the link:http://swagger.io/swagger-ui/[Sw
[NOTE]
====
-Not all of the REST API exposed by the xref:../ugvro/ugvro.adoc#[Restful Objects viewer] is included in the Swagger spec files; the emphasis is those REST resources that are used to develop custom apps: domain objects, domain object collections and action invocations. When combined with Apache Isis' own xref:../ugvro/ugvro.adoc#_ugvro_simplified-representations[simplified representations], these are pretty much all that is needed for this use case.
+Not all of the REST API exposed by the xref:../ugvro/ugvro.adoc#[Restful Objects viewer] is included in the Swagger schema definition files; the emphasis is those REST resources that are used to develop custom apps: domain objects, domain object collections and action invocations. When combined with Apache Isis' own xref:../ugvro/ugvro.adoc#_ugvro_simplified-representations[simplified representations], these are pretty much all that is needed for this use case.
====
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_presentation-layer-spi_ContentMappingService.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_presentation-layer-spi_ContentMappingService.adoc b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_presentation-layer-spi_ContentMappingService.adoc
index 71d5fb9..84eb36b 100644
--- a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_presentation-layer-spi_ContentMappingService.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_presentation-layer-spi_ContentMappingService.adoc
@@ -6,10 +6,7 @@
-The `ContentMappingService` supports the (default implementation of the)
-xref:../rgfis/rgfis.adoc#_rgfis_presentation-layer_ContentNegotiationService[`ContentNegotiationService`] allowing the
-xref:../ugvro/ugvro.adoc#[RestfulObjects viewer] to allow domain objects to be transformed into some other format as specified
-by the HTTP `Accept` header.
+The `ContentMappingService` supports the (default implementation of the) xref:../rgfis/rgfis.adoc#_rgfis_presentation-layer_ContentNegotiationService[`ContentNegotiationService`] enabling the xref:../ugvro/ugvro.adoc#[RestfulObjects viewer] to represent domain objects in some other format as specified by the HTTP `Accept` header.
See xref:../rgfis/rgfis.adoc#_rgfis_presentation-layer_ContentNegotiationService[`ContentNegotiationService`] for further discussion.
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_presentation-layer-spi_ErrorReportingService.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_presentation-layer-spi_ErrorReportingService.adoc b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_presentation-layer-spi_ErrorReportingService.adoc
index 22a673b..4184704 100644
--- a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_presentation-layer-spi_ErrorReportingService.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_presentation-layer-spi_ErrorReportingService.adoc
@@ -5,8 +5,9 @@
:_imagesdir: images/
-The `ErrorReportingService` service is an optional SPI that providies the ability to record any errors/exceptions that
- might occur in the application into an external incident recording system (such as JIRA). The service also allows
+The `ErrorReportingService` service is an optional SPI that provides the ability to record any errors/exceptions that
+ might occur in the application into an external incident recording system (such as JIRA).
+The service also allows
a user-friendly (jargon-free) error message to be returned and rendered to the end-user, along with an optional
incident reference (eg a JIRA issue `XXX-1234`).
@@ -34,10 +35,14 @@ public class ErrorDetails {
public List<String> getStackTraceDetailList() { // <4>
}
----
-<1> the main message to be displayed to the end-user. The service is responsible for translating this into the language of the end-user (it can use xref:../rgsvc/rgsvc.adoc#_rgsvc_presentation-layer-spi_LocaleProvider[`LocaleProvider`] if required).
-<2> whether this message has already been recognized by an xref:../rgsvc/rgsvc.adoc#_rgsvc_presentation-layer-spi_ExceptionRecognizer[`ExceptionRecognizer`] service. Generally this converts potentially non-recoverable (fatal) exceptions into recoverable exceptions (warnings) as well providing an alternative mechanism for generating user-friendly error messages.
-<3> whether the cause of the exception was due to a lack of privileges. In such cases the UI restricts the information shown to the end-user, to avoid leaking potentially sensitive information
-<4> the stack trace of the exception, including the trace of any exceptions in the causal chain. These technical details are hidden from the user and only shown for non-recoverable exceptions.
+<1> the main message to be displayed to the end-user.
+The service is responsible for translating this into the language of the end-user (it can use xref:../rgsvc/rgsvc.adoc#_rgsvc_presentation-layer-spi_LocaleProvider[`LocaleProvider`] if required).
+<2> whether this message has already been recognized by an xref:../rgsvc/rgsvc.adoc#_rgsvc_presentation-layer-spi_ExceptionRecognizer[`ExceptionRecognizer`] service.
+Generally this converts potentially non-recoverable (fatal) exceptions into recoverable exceptions (warnings) as well providing an alternative mechanism for generating user-friendly error messages.
+<3> whether the cause of the exception was due to a lack of privileges.
+In such cases the UI restricts the information shown to the end-user, to avoid leaking potentially sensitive information
+<4> the stack trace of the exception, including the trace of any exceptions in the causal chain.
+These technical details are hidden from the user and only shown for non-recoverable exceptions.
and `Ticket` (returned by the service) has the constructor:
@@ -51,13 +56,12 @@ public class Ticket implements Serializable {
final String details) { ... } // <3>
}
----
-<1> is a unique identifier that the end-user can use to track any follow-up from this error. For example, an
-implementation might automatically log an issue in a bug tracking system such as JIRA, in which case the reference would
+<1> is a unique identifier that the end-user can use to track any follow-up from this error.
+For example, an implementation might automatically log an issue in a bug tracking system such as JIRA, in which case the reference would
probably be the JIRA issue number <tt>XXX-1234</tt>.
<2> a short, jargon-free message to display to the end-user.
-<3> is optional additional details to show. For example, these might include text on how to recover from the error, or
- workarounds, or just further details on contacting the help desk if the issue is severe and requires immediate
- attention.
+<3> is optional additional details to show.
+For example, these might include text on how to recover from the error, or workarounds, or just further details on contacting the help desk if the issue is severe and requires immediate attention.
@@ -99,8 +103,6 @@ image::{_imagesdir}reference-services-spi/ErrorReportingService/kitchensink-exam
== Registering the Services
-There is no default implementation of this service. To register your own implementation (and assuming that an
-`AppManifest` is being used to xref:../rgcms/rgcms.adoc#_rgcms_classes_AppManifest-bootstrapping[bootstrap the app]), then just
-ensure that the implementation is on the classpath and the module containing the implementation is returned in
-`AppManifest#getModules()`.
+There is no default implementation of this service.
+To register your own implementation (and assuming that an `AppManifest` is being used to xref:../rgcms/rgcms.adoc#_rgcms_classes_AppManifest-bootstrapping[bootstrap the app]), then just ensure that the implementation is on the classpath and the module containing the implementation is returned in `AppManifest#getModules()`.
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/adocs/documentation/src/main/asciidoc/guides/ugsec/_ugsec_usage-by-isis-viewers.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/ugsec/_ugsec_usage-by-isis-viewers.adoc b/adocs/documentation/src/main/asciidoc/guides/ugsec/_ugsec_usage-by-isis-viewers.adoc
index b095635..27d01be 100644
--- a/adocs/documentation/src/main/asciidoc/guides/ugsec/_ugsec_usage-by-isis-viewers.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/ugsec/_ugsec_usage-by-isis-viewers.adoc
@@ -125,7 +125,7 @@ The strategy is configured in `web.xml`; for example:
----
<1> configure basic auth strategy
<2> what to do if no session was found; we use `auto` so as to issue a 401 status code with basic authentication challenge if the request originated from a web browser. (Prior to `1.11.0` this parameter was set either to `basicAuthChallenge` (which works when requested from web browser) or to `unauthorized` (which works when requested from a suitably coded custom Javascript app).
-<3> which paths are allowed to be accessed directly, without a session. The `/restful/swagger` path provides access to the SwaggerResource that dynamically generates swagger spec files from the Apache Isis metamodel.
+<3> which paths are allowed to be accessed directly, without a session. The `/restful/swagger` path provides access to the SwaggerResource that dynamically generates swagger schema definition files from the Apache Isis metamodel.
The above filter must then be chained before the servlet that actually handles the REST requests:
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.8.0-to-1.9.0_fixture-scripts-specification-provider.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.8.0-to-1.9.0_fixture-scripts-specification-provider.adoc b/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.8.0-to-1.9.0_fixture-scripts-specification-provider.adoc
index ba2da9e..51492a1 100644
--- a/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.8.0-to-1.9.0_fixture-scripts-specification-provider.adoc
+++ b/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.8.0-to-1.9.0_fixture-scripts-specification-provider.adoc
@@ -6,7 +6,7 @@
-The `FixtureScriptsSpecificationProvider` SPI service is an alternative to subclassing the xref:../guides/rgcms/rgcms.adoc#_rgcms_classes_super_FixtureScripts[`FixtureScripts`] domain service. The logic that would normally be in the subclass moves to the provider service instead, and the framework instantiates a fallback default instance, xref:guides/rgsvc/rgsvc.adoc#_rgsvc_testing_FixtureScriptsDefault[`FixtureScriptsDefault`].
+The `FixtureScriptsSpecificationProvider` SPI service is an alternative to subclassing the xref:../guides/rgcms/rgcms.adoc#_rgcms_classes_super_FixtureScripts[`FixtureScripts`] domain service. The logic that would normally be in the subclass moves to the provider service instead, and the framework instantiates a fallback default instance, xref:../guides/rgsvc/rgsvc.adoc#_rgsvc_testing_FixtureScriptsDefault[`FixtureScriptsDefault`].
This new design is optional; if you continue to provide your own subclass then everything will continue as before. However the new design is more flexible and involves less code.
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/adapters/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/adapters/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/adapters/package-info.java
index 0dc1b87..a624836 100644
--- a/core/applib/src/main/java/org/apache/isis/applib/adapters/package-info.java
+++ b/core/applib/src/main/java/org/apache/isis/applib/adapters/package-info.java
@@ -18,9 +18,16 @@
*/
/**
- * The classes in this package are used for implementing custom value types.
+ * The classes in this package are used for implementing custom value types.
*
* <p>
+ * <b>NOTE THAT</b> in addition to implementing the interfaces here, it is also necessary to provide appropriate
+ * components for Wicket viewer to edit the values and to implement the appropriate SPI/extension points so that
+ * DataNucleus can persist the objects to the database.
+ * </p>
+ *
+ *
+ * <p>
* The {@link org.apache.isis.applib.adapters.ValueSemanticsProvider} interface
* allows the framework to recognize its corresponding type as being a value
* type (that is, having value semantics). The {@link org.apache.isis.applib.adapters.AbstractValueSemanticsProvider}
@@ -32,6 +39,9 @@
* is to annotate the class with the {@link org.apache.isis.applib.annotation.Value}
* annotation. However, if the value type source code cannot be modified (for
* example, if it is a third-party type such as joda-time), then the association
- * can be made using configuration properties.
+ * can be made using configuration properties.
+ *
+ * @deprecated
*/
+@Deprecated
package org.apache.isis.applib.adapters;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/annotation/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/annotation/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/annotation/package-info.java
new file mode 100644
index 0000000..1b64fdd
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/annotation/package-info.java
@@ -0,0 +1,23 @@
+/*
+ * 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.
+ */
+
+/**
+ *
+ */
+package org.apache.isis.applib.annotation;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/conmap/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/conmap/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/conmap/package-info.java
new file mode 100644
index 0000000..8bec606
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/conmap/package-info.java
@@ -0,0 +1,27 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.conmap.ContentMappingService} supports the (default implementation of the)
+ * <code>ContentNegotiationService</code> enabling the RestfulObjects viewer to represent domain objects in some other
+ * format as specified by the HTTP <code>Accept</code> header.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_ContentMappingService">Reference Guide</a>
+ */
+package org.apache.isis.applib.conmap;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/events/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/events/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/events/package-info.java
index 9849bab..bae4930 100644
--- a/core/applib/src/main/java/org/apache/isis/applib/events/package-info.java
+++ b/core/applib/src/main/java/org/apache/isis/applib/events/package-info.java
@@ -18,13 +18,9 @@
*/
/**
- * Interaction events, corresponding to gestures in the user interface.
- *
- * <p>
- * The applib does not provide any means of listening to these events directly, and typically
- * domain objects would not be interested in them either. However, they can be subscribed to
- * using the wrapper progmodel (which effectively provides a drop-in replacement for the
- * {@link org.apache.isis.applib.DomainObjectContainer} that implements the <tt>WrapperFactory</tt>
- * interface).
+ * Interaction events, corresponding to gestures in the user interface; emitted only by the
+ * {@link org.apache.isis.applib.services.wrapper.WrapperFactory}.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_WrapperFactory">Reference Guide</a>
*/
package org.apache.isis.applib.events;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/filter/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/filter/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/filter/package-info.java
index 7d3131b..2749559f 100644
--- a/core/applib/src/main/java/org/apache/isis/applib/filter/package-info.java
+++ b/core/applib/src/main/java/org/apache/isis/applib/filter/package-info.java
@@ -25,5 +25,8 @@
* <p>
* It also defines a supporting {@link org.apache.isis.applib.filter.Filters utility class}
* which can be used to combine {@link org.apache.isis.applib.filter.Filter}s.
+ *
+ * @deprecated
*/
+@Deprecated
package org.apache.isis.applib.filter;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/fixtures/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/fixtures/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/fixtures/package-info.java
index c31278f..f848348 100644
--- a/core/applib/src/main/java/org/apache/isis/applib/fixtures/package-info.java
+++ b/core/applib/src/main/java/org/apache/isis/applib/fixtures/package-info.java
@@ -20,6 +20,12 @@
/**
* Defines the {@link org.apache.isis.applib.fixtures.InstallableFixture}
* interface and supporting classes.
+ *
+ * <p>
+ * <b>NOTE THAT</b> {@link org.apache.isis.applib.fixturescripts.FixtureScript} interface provides a more complete
+ * approach to handling fixtures, and should generally be used in preference to
+ * {@link org.apache.isis.applib.fixtures.InstallableFixture}.
+ * </p>
*
* <p>
* Fixtures are used to initialize the system, typically for either testing
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/fixturescripts/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/fixturescripts/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/fixturescripts/package-info.java
new file mode 100644
index 0000000..6863d3f
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/fixturescripts/package-info.java
@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+
+/**
+ * Provides a mechanism to set up an application, typically running in prototype mode (with an in-memory database)
+ * or for integration testing.
+ *
+ * @see <a href="http://isis.apache.org/guides/ugtst/ugtst.html#_ugtst_fixture-scripts">Testing guide</a>.
+ */
+package org.apache.isis.applib.fixturescripts;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/layout/component/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/layout/component/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/layout/component/package-info.java
index 49bcff5..e10905a 100644
--- a/core/applib/src/main/java/org/apache/isis/applib/layout/component/package-info.java
+++ b/core/applib/src/main/java/org/apache/isis/applib/layout/component/package-info.java
@@ -18,22 +18,6 @@
*/
/**
- * The classes in this package provide layout metadata for a domain object's properties, collections and actions - the
- * "building blocks" which then must be arranged into some sort of layout.
- *
- * <p>
- * The <code>bootstrap3</code> and <code>fixedcols</code> packages both provide different ways of doing the layout,
- * and both reference the classes in this package.
- * </p>
*
*/
-@javax.xml.bind.annotation.XmlSchema(
- namespace = "http://isis.apache.org/applib/layout/component",
- elementFormDefault = javax.xml.bind.annotation.XmlNsForm.QUALIFIED,
- xmlns = {
- @javax.xml.bind.annotation.XmlNs(
- namespaceURI = "http://isis.apache.org/applib/layout/component", prefix = "cpt")
- } // specifying the location seems to cause JaxbService#toXsd() to not generate the schema; not sure why...
- //, location = ..."http://isis.apache.org/schema/metamodel/layout/common/common.xsd"
-)
package org.apache.isis.applib.layout.component;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/layout/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/layout/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/layout/package-info.java
new file mode 100644
index 0000000..f67a4e4
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/layout/package-info.java
@@ -0,0 +1,25 @@
+/*
+ * 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.
+ */
+
+/**
+ * Support for file-based layouts.
+ *
+ * @see <a href="http://isis.apache.org/guides/ugvw/ugvw.html#_ugvw_layout_file-based">User guide</a>
+ */
+package org.apache.isis.applib.layout;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/profiles/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/profiles/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/profiles/package-info.java
deleted file mode 100644
index baefae8..0000000
--- a/core/applib/src/main/java/org/apache/isis/applib/profiles/package-info.java
+++ /dev/null
@@ -1,36 +0,0 @@
-/*
- * 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.
- */
-
-/**
- * Defines interfaces for domain objects that constitute the framework's
- * view of a "user profile".
- *
- * <p>
- * Each user can hold a single {@link org.apache.isis.applib.profiles.Profile},
- * which in turn can hold option settings (eg preferred colour theme) and
- * {@link org.apache.isis.applib.profiles.Perspective}s (a particular
- * arrangement of the user interface; the terminology comes from the Eclipse
- * RCP/IDE platform).
- *
- * <p>
- * The use and surfacing of these capabilities is dependent on the viewer;
- * most notably the drag-n-drop viewer does support the concept of a user
- * profile, but many others do not.
- */
-package org.apache.isis.applib.profiles;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/query/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/query/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/query/package-info.java
index 1d7db70..057d127 100644
--- a/core/applib/src/main/java/org/apache/isis/applib/query/package-info.java
+++ b/core/applib/src/main/java/org/apache/isis/applib/query/package-info.java
@@ -29,8 +29,6 @@
* can submit. Object store implementation are generally expected to support
* the {@link org.apache.isis.applib.query.QueryBuiltInAbstract built-in queries},
* meaning that there may not be any need to provide different implementations
- * of the repositories. (This provides some of the benefits that .NET has
- * with its LINQ technology, though it is admittedly nowhere near as
- * sophisticated).
+ * of the repositories.
*/
package org.apache.isis.applib.query;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/acceptheader/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/acceptheader/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/acceptheader/package-info.java
new file mode 100644
index 0000000..3d4f62f
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/acceptheader/package-info.java
@@ -0,0 +1,30 @@
+/*
+ * 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.
+ */
+
+/**
+ * The @{@link org.apache.isis.applib.services.acceptheader.AcceptHeaderService} domain service is a
+ * <code>@RequestScoped</code> service that simply exposes the HTTP Accept header to the domain.
+ *
+ * <p>
+ * Its intended use is to support multiple versions of a REST API, where the responsibility for content negotiation (determining which version of the REST API is to be used) is managed by
+ * </p>
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_AcceptHeaderService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.acceptheader;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/actinvoc/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/actinvoc/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/actinvoc/package-info.java
new file mode 100644
index 0000000..1c52c3e
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/actinvoc/package-info.java
@@ -0,0 +1,31 @@
+/*
+ * 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.
+ */
+
+/**
+ * The @{@link org.apache.isis.applib.services.actinvoc.ActionInvocationContext} domain service is a
+ * <code>@RequestScoped</code> service intended to support the implementation of "bulk" actions annotated with
+ * {@link org.apache.isis.applib.annotation.Action#invokeOn()}.
+ *
+ * <p>
+ * This allows the user to select multiple objects in a table and then invoke the same action against all of them.
+ * </p>
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_ActionInvocationContext">Reference guide</a>
+ */
+package org.apache.isis.applib.services.actinvoc;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/appfeat/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/appfeat/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/appfeat/package-info.java
new file mode 100644
index 0000000..6b85775
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/appfeat/package-info.java
@@ -0,0 +1,27 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.appfeat.ApplicationFeatureRepository} provides the access to string
+ * representations of the packages, classes and class members (collectively: "application features") of the
+ * domain classes within the Apache Isis' internal metamodel.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_metadata-api_ApplicationFeatureRepository">Reference guide</a>
+ */
+package org.apache.isis.applib.services.appfeat;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/audit/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/audit/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/audit/package-info.java
new file mode 100644
index 0000000..1018861
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/audit/package-info.java
@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.audit.AuditerService} auditing service provides a simple mechanism to
+ * capture changes to data. It is called for each property that has changed on any domain object, as a set of pre- and post-values.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_persistence-layer-spi_AuditerService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.audit;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/background/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/background/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/background/package-info.java
new file mode 100644
index 0000000..3527101
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/background/package-info.java
@@ -0,0 +1,27 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.background.BackgroundService2} domain service, and also the companion
+ * {@link org.apache.isis.applib.services.background.BackgroundCommandService2} SPI service, enable commands to be
+ * persisted such that they may be invoked in the background
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_BackgroundService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.background;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/bookmark/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/bookmark/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/bookmark/package-info.java
new file mode 100644
index 0000000..d36bebf
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/bookmark/package-info.java
@@ -0,0 +1,27 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.bookmark.BookmarkService2} API provides the ability to obtain a
+ * serializable {@link org.apache.isis.applib.services.bookmark.Bookmark} for any (persisted) domain object, and to
+ * lookup domain objects given a Bookmark. This can then in turn be converted to and from a string.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_integration-api_BookmarkService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.bookmark;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/classdiscovery/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/classdiscovery/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/classdiscovery/package-info.java
new file mode 100644
index 0000000..e45cfd0
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/classdiscovery/package-info.java
@@ -0,0 +1,27 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.classdiscovery.ClassDiscoveryService2} service is used to automatically
+ * discover subclasses of any given type on the classpath. The primary use case is to support
+ * "convention-over-configuration" designs that work with a minimum of configuration.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_bootstrapping-spi_ClassDiscoveryService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.classdiscovery;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/clock/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/clock/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/clock/package-info.java
new file mode 100644
index 0000000..c87f8d5
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/clock/package-info.java
@@ -0,0 +1,25 @@
+/*
+ * 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.
+ */
+
+/**
+ * This domain service provides current time.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_core-domain-api_ClockService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.clock;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/command/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/command/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/command/package-info.java
new file mode 100644
index 0000000..e769c49
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/command/package-info.java
@@ -0,0 +1,27 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.command.CommandContext} service is a request-scoped service that reifies
+ * the invocation of an action on a domain object into an object itself. This reified information is encapsulated
+ * within the {@link org.apache.isis.applib.services.command.Command} object.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_CommandContext">Reference guide</a>
+ */
+package org.apache.isis.applib.services.command;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/config/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/config/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/config/package-info.java
new file mode 100644
index 0000000..99814d4
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/config/package-info.java
@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.config.ConfigurationService} allows domain objects to read the
+ * configuration properties aggregated from the various configuration files.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_core-domain-api_ConfigurationService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.config;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/dto/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/dto/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/dto/package-info.java
new file mode 100644
index 0000000..55c325a
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/dto/package-info.java
@@ -0,0 +1,28 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.dto.Dto} role interface is intended to be implemented by JAXB-annotated
+ * view models, that is, annotated using <code>@XmlRootElement</code>. It enables the ability to download the XML and
+ * XSD schema of those objects using two mixins, {@link org.apache.isis.applib.services.dto.Dto_downloadXml} and
+ * {@link org.apache.isis.applib.services.dto.Dto_downloadXsd}.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgcms/rgcms.html#_rgcms_classes_mixins_Dto">Classes, Methods & Schema guide</a>
+ */
+package org.apache.isis.applib.services.dto;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/email/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/email/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/email/package-info.java
new file mode 100644
index 0000000..27573af
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/email/package-info.java
@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.email.EmailService} provides the ability to send HTML emails, with
+ * attachments, to one or more recipients.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_integration-api_EmailService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.email;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/error/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/error/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/error/package-info.java
new file mode 100644
index 0000000..48c9cf2
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/error/package-info.java
@@ -0,0 +1,28 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.error.ErrorReportingService} service is an optional SPI that provides
+ * the ability to record any errors/exceptions that might occur in the application into an external incident recording
+ * system (such as JIRA). The service also allows a user-friendly (jargon-free) error message to be returned and
+ * rendered to the end.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_ErrorReportingService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.error;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/eventbus/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/eventbus/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/eventbus/package-info.java
new file mode 100644
index 0000000..34a4e86
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/eventbus/package-info.java
@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.eventbus.EventBusService} allows domain objects to emit events to
+ * subscribing domain services using an in-memory event bus.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_core-domain-api_EventBusService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.eventbus;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/exceprecog/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/exceprecog/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/exceprecog/package-info.java
new file mode 100644
index 0000000..c10819d
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/exceprecog/package-info.java
@@ -0,0 +1,28 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.exceprecog.ExceptionRecognizer} service provides the mechanism for both
+ * the domain programmer and also for components to be able to recognize and handle certain exceptions that may be
+ * thrown by the system. Rather than display an obscure error to the end-user, the application can instead display a
+ * user-friendly message
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_ExceptionRecognizer">Reference guide</a>
+ */
+package org.apache.isis.applib.services.exceprecog;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/factory/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/factory/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/factory/package-info.java
new file mode 100644
index 0000000..73a92f3
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/factory/package-info.java
@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.factory.FactoryService} collects together methods for instantiating
+ * domain objects.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_core-domain-api_FactoryService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.factory;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/fixturespec/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/fixturespec/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/fixturespec/package-info.java
new file mode 100644
index 0000000..0171250
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/fixturespec/package-info.java
@@ -0,0 +1,28 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.fixturespec.FixtureScriptsSpecificationProvider} SPI service is an
+ * alternative to subclassing the {@link org.apache.isis.applib.fixturescripts.FixtureScripts} domain service.
+ * The logic that would normally be in the subclass moves to the provider service instead, and the framework
+ * instantiates a fallback default instance, {@link org.apache.isis.applib.services.fixturespec.FixtureScriptsDefault}.
+ *
+ * @see <a href="http://isis.apache.org/migration-notes/migration-notes.html#_migration-notes_1.8.0-to-1.9.0_fixture-scripts-specification-provider">Reference guide</a>
+ */
+package org.apache.isis.applib.services.fixturespec;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/grid/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/grid/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/grid/package-info.java
new file mode 100644
index 0000000..52e28c3
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/grid/package-info.java
@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.grid.GridService} encapsulates a single layout grid system which
+ * can be used to customize the layout of domain objects.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_GridService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.grid;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/guice/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/guice/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/guice/package-info.java
new file mode 100644
index 0000000..f35fce8
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/guice/package-info.java
@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.guice.GuiceBeanProvider} domain service acts as a bridge between
+ * Apache Isis' Wicket viewer internal bootstrapping using Google Guice.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_integration-api_GuiceBeanProvider">Reference guide</a>
+ */
+package org.apache.isis.applib.services.guice;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/hint/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/hint/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/hint/package-info.java
new file mode 100644
index 0000000..f282009
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/hint/package-info.java
@@ -0,0 +1,28 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.hint.HintStore} service defines an SPI for the Wicket viewer to store
+ * UI hints on a per-object basis. For example, the viewer remembers which tabs are selected, and for collections
+ * which view is selected (eg table or hidden), which page of a table to render, or whether "show all" (rows) is
+ * toggled.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_HintStore">Reference guide</a>
+ */
+package org.apache.isis.applib.services.hint;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/homepage/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/homepage/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/homepage/package-info.java
new file mode 100644
index 0000000..12dd15c
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/homepage/package-info.java
@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.homepage.HomePageProviderService} service simply provides access to the
+ * home page object (if any) that is returned from the domain service action annotated with {@link org.apache.isis.applib.annotation.HomePage @HomePage}.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-spi_HomePageProviderService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.homepage;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/hsqldb/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/hsqldb/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/hsqldb/package-info.java
new file mode 100644
index 0000000..6b23084
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/hsqldb/package-info.java
@@ -0,0 +1,28 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.i18n.TranslationService} is the cornerstone of Apache Isis' i18n support.
+ * Its role is to be able to provide translated versions of the various elements within the Apache Isis metamodel
+ * (service and object classes, properties, collections, actions, action parameters) and also to translate business
+ * rule (disable/valid) messages, and exceptions. These translations provide for both singular and plural forms.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_TranslationService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.hsqldb;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/i18n/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/i18n/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/i18n/package-info.java
new file mode 100644
index 0000000..e504b05
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/i18n/package-info.java
@@ -0,0 +1,24 @@
+/*
+ * 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.
+ */
+
+/**
+ *
+ * @see <a href="">Reference guide</a>
+ */
+package org.apache.isis.applib.services.i18n;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/iactn/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/iactn/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/iactn/package-info.java
new file mode 100644
index 0000000..2bbbd04
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/iactn/package-info.java
@@ -0,0 +1,29 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.iactn.InteractionContext} is a request-scoped domain service that is used
+ * to obtain the current {@link org.apache.isis.applib.services.iactn.Interaction}.
+ * An Interaction in turn generally consists of a single top-level Execution, either to invoke an action or to edit
+ * a property. If that top-level action or property uses the {@link org.apache.isis.applib.services.wrapper.WrapperFactory} to invoke child actions/properties, then
+ * those sub-executions are captured as a call-graph. The Execution is thus a graph structure.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#__code_interactioncontext_code">Reference guide</a>
+ */
+package org.apache.isis.applib.services.iactn;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/jaxb/JaxbService.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/jaxb/JaxbService.java b/core/applib/src/main/java/org/apache/isis/applib/services/jaxb/JaxbService.java
index d44e140..a4cebb8 100644
--- a/core/applib/src/main/java/org/apache/isis/applib/services/jaxb/JaxbService.java
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/jaxb/JaxbService.java
@@ -23,7 +23,6 @@ import java.lang.reflect.Method;
import java.util.List;
import java.util.Map;
-import javax.inject.Inject;
import javax.xml.bind.JAXBContext;
import javax.xml.bind.JAXBException;
import javax.xml.bind.Marshaller;
[2/7] isis git commit: ISIS-1685: adds missing package-info.java for
applib
Posted by da...@apache.org.
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/jaxb/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/jaxb/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/jaxb/package-info.java
new file mode 100644
index 0000000..4114194
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/jaxb/package-info.java
@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.jaxb.JaxbService} allows instances of JAXB-annotated classes to be
+ * marshalled to XML and unmarshalled from XML back into domain objects.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_integration-api_JaxbService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.jaxb;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/jdosupport/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/jdosupport/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/jdosupport/package-info.java
new file mode 100644
index 0000000..8b0f601
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/jdosupport/package-info.java
@@ -0,0 +1,29 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.jdosupport.IsisJdoSupport} service provides a number of general purpose
+ * methods for working with the JDO/DataNucleus objectstore. In general these act at a lower-level of abstraction than
+ * the APIs normally used (specifically, those of {@link org.apache.isis.applib.services.repository.RepositoryService}),
+ * but nevertheless deal with some of the most common use cases. For service also provides access to the underlying
+ * JDO PersistenceManager for full control.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_persistence-layer-api_IsisJdoSupport">Reference guide</a>
+ */
+package org.apache.isis.applib.services.jdosupport;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/layout/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/layout/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/layout/package-info.java
new file mode 100644
index 0000000..f387656
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/layout/package-info.java
@@ -0,0 +1,27 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.layout.LayoutService} provides the ability to obtain the XML layout
+ * for a single domain object or for all domain objects. This functionality is surfaced through the user interface
+ * through a related mixin and menu action.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_metadata-api_LayoutService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.layout;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/linking/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/linking/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/linking/package-info.java
new file mode 100644
index 0000000..77fbc92
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/linking/package-info.java
@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.linking.DeepLinkService} provides the ability to obtain a
+ * <code>java.net.URI</code> that links to a representation of any (persisted) domain entity or view model.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_integration-api_DeepLinkService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.linking;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/memento/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/memento/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/memento/package-info.java
new file mode 100644
index 0000000..4a61991
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/memento/package-info.java
@@ -0,0 +1,30 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.memento.MementoService} was originally introduced to simplify the
+ * implementation of ViewModels 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. This usage is deprecated; use JAXB view models instead.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_integration-api_MementoService">Reference guide</a>
+ *
+ * @deprecated
+ */
+@Deprecated
+package org.apache.isis.applib.services.memento;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/message/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/message/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/message/package-info.java
new file mode 100644
index 0000000..cf699a6
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/message/package-info.java
@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.message.MessageService} allows domain objects to raise information,
+ * warning or error messages. These messages can either be simple strings, or can be translated.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_MessageService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.message;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/metamodel/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/metamodel/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/metamodel/package-info.java
new file mode 100644
index 0000000..383759b
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/metamodel/package-info.java
@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.metamodel.MetaModelService3} service provides access to a number of
+ * aspects of Apache Isis' internal metamodel.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_metadata-api_MetamodelService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.metamodel;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/metrics/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/metrics/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/metrics/package-info.java
new file mode 100644
index 0000000..e93d3cd
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/metrics/package-info.java
@@ -0,0 +1,27 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.metrics.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.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_persistence-layer-api_MetricsService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.metrics;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/package-info.java
new file mode 100644
index 0000000..8678ea9
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/package-info.java
@@ -0,0 +1,24 @@
+/*
+ * 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.
+ */
+
+/**
+ * Defines a set of domain service APIs and SPIs. APIs are implemented by the framework (for the application to call),
+ * SPIs are hooks called by framework if an implementation provided by application.
+ */
+package org.apache.isis.applib.services;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/publish/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/publish/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/publish/package-info.java
new file mode 100644
index 0000000..37bc385
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/publish/package-info.java
@@ -0,0 +1,28 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.publish.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 ActiveMQ with Camel to keep other systems up to date.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_persistence-layer-spi_PublisherService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.publish;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/queryresultscache/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/queryresultscache/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/queryresultscache/package-info.java
new file mode 100644
index 0000000..290f779
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/queryresultscache/package-info.java
@@ -0,0 +1,27 @@
+/*
+ * 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.
+ */
+
+/**
+ * The purpose of the {@link org.apache.isis.applib.services.queryresultscache.QueryResultsCache} is to improve
+ * response times to the user, by providing a request-scoped cache of the value of some (safe or idempotent) method
+ * call. This will typically be as the result of running a query, but could be any expensive operation.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_persistence-layer-api_QueryResultsCache">Reference guide</a>
+ */
+package org.apache.isis.applib.services.queryresultscache;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/registry/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/registry/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/registry/package-info.java
new file mode 100644
index 0000000..ba3cc43
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/registry/package-info.java
@@ -0,0 +1,27 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.registry.ServiceRegistry2} service collects together methods injecting
+ * or looking up domain services (either provided by the framework or application-specific) currently known to the
+ * runtime.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_metadata-api_ServiceRegistry">Reference guide</a>
+ */
+package org.apache.isis.applib.services.registry;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/repository/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/repository/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/repository/package-info.java
new file mode 100644
index 0000000..aa4cb8a
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/repository/package-info.java
@@ -0,0 +1,27 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.repository.RepositoryService} collects together methods for creating,
+ * persisting and searching for entities from the underlying persistence store. It acts as an abstraction over the
+ * JDO/DataNucleus objectstore.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_persistence-layer-api_RepositoryService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.repository;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/routing/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/routing/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/routing/package-info.java
new file mode 100644
index 0000000..ca4abd2
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/routing/package-info.java
@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.routing.RoutingService} provides the ability to return (and therefore
+ * render) an alternative object from an action invocation.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_RoutingService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.routing;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/scratchpad/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/scratchpad/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/scratchpad/package-info.java
new file mode 100644
index 0000000..b121297
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/scratchpad/package-info.java
@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.scratchpad.Scratchpad} (request-scoped) domain service allows objects to
+ * exchange information even if they do not directly call each other.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_core-domain-api_Scratchpad">Reference guide</a>
+ */
+package org.apache.isis.applib.services.scratchpad;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/session/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/session/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/session/package-info.java
new file mode 100644
index 0000000..ec455bf
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/session/package-info.java
@@ -0,0 +1,24 @@
+/*
+ * 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.
+ */
+
+/**
+ *
+ * @see <a href="">Reference guide</a>
+ */
+package org.apache.isis.applib.services.session;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/sessmgmt/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/sessmgmt/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/sessmgmt/package-info.java
new file mode 100644
index 0000000..c9edede
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/sessmgmt/package-info.java
@@ -0,0 +1,28 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.sessmgmt.SessionManagementService} provides the ability to
+ * programmatically manage sessions. The primary use case is for fixture scripts or other routines that are invoked
+ * from the UI and which create or modify large amounts of data. A classic example is migrating data from one system
+ * to another.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_SessionManagementService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.sessmgmt;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/settings/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/settings/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/settings/package-info.java
new file mode 100644
index 0000000..6664a44
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/settings/package-info.java
@@ -0,0 +1,24 @@
+/*
+ * 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.
+ */
+
+/**
+ * @deprecated
+ */
+@Deprecated
+package org.apache.isis.applib.services.settings;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/sudo/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/sudo/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/sudo/package-info.java
new file mode 100644
index 0000000..2b8fae9
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/sudo/package-info.java
@@ -0,0 +1,29 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.sudo.SudoService} allows the current user reported by the
+ * {@link org.apache.isis.applib.services.user.UserService} to be temporarily changed to some other user. This is
+ * useful both for integration testing (eg if testing a workflow system whereby objects are moved from one user to
+ * another) and while running fixture scripts (eg setting up objects that would normally require several users to have
+ * acted upon the objects).
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_testing_SudoService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.sudo;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/swagger/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/swagger/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/swagger/package-info.java
new file mode 100644
index 0000000..4a2a3fd
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/swagger/package-info.java
@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link SwaggerService} generates Swagger schema definition files to describe the public and/or private
+ * RESTful APIs exposed by the RestfulObjects viewer.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_metadata-api_SwaggerService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.swagger;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/tablecol/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/tablecol/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/tablecol/package-info.java
new file mode 100644
index 0000000..84f8cb3
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/tablecol/package-info.java
@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link TableColumnOrderService} provides the ability to reorder (or suppress) columns in both parented- and
+ * standalone tables
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_TableColumnOrderService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.tablecol;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/timestamp/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/timestamp/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/timestamp/package-info.java
new file mode 100644
index 0000000..0686e36
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/timestamp/package-info.java
@@ -0,0 +1,25 @@
+/*
+ * 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.
+ */
+
+/**
+ * Defines a number of interfaces for mixins to contribute to.
+ *
+ * @see <a href="">Reference guide</a>
+ */
+package org.apache.isis.applib.services.timestamp;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/title/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/title/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/title/package-info.java
new file mode 100644
index 0000000..a6ea945
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/title/package-info.java
@@ -0,0 +1,25 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link TitleService} provides methods to programmatically obtain the title and icon of a domain object.
+
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_TitleService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.title;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/urlencoding/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/urlencoding/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/urlencoding/package-info.java
new file mode 100644
index 0000000..066cea3
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/urlencoding/package-info.java
@@ -0,0 +1,29 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link UrlEncodingService} defines a consistent way to convert strings to/from a form safe for use within a URL.
+ * The service is used by the framework to map view model mementos (derived from the state of the view model itself)
+ * into a form that can be used as a view model. When the framework needs to recreate the view model (for example to
+ * invoke an action on it), this URL is converted back into a view model memento, from which the view model can then
+ * be hydrated
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_UrlEncodingService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.urlencoding;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/user/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/user/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/user/package-info.java
new file mode 100644
index 0000000..b9e2a8a
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/user/package-info.java
@@ -0,0 +1,25 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link UserService} allows the domain object to obtain the identity of the user interacting with said object.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_core-domain-api_UserService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.user;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/userprof/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/userprof/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/userprof/package-info.java
new file mode 100644
index 0000000..ed5b3c0
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/userprof/package-info.java
@@ -0,0 +1,28 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.userprof.UserProfileService} provides the ability for the domain
+ * application to return supplementary metadata about the current user. This information is used (by the Wicket viewer)
+ * to customize the appearance of the tertiary "Me" menu bar (top right). For example, rather than display the
+ * username, instead the user’s first and last name could be displayed.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_UserProfileService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.userprof;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/userreg/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/userreg/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/userreg/package-info.java
new file mode 100644
index 0000000..e508ab6
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/userreg/package-info.java
@@ -0,0 +1,27 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.userreg.UserRegistrationService} provides the ability for users to
+ * sign-up to access an application by providing a valid email address, and also provides the capability for users to
+ * reset their password if forgotten.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_persistence-layer-spi_UserRegistrationService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.userreg;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/wrapper/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/wrapper/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/wrapper/package-info.java
new file mode 100644
index 0000000..86186a0
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/wrapper/package-info.java
@@ -0,0 +1,28 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.wrapper.WrapperFactory} provides the ability to enforce business rules
+ * for programmatic interactions between domain objects. If there is a (lack-of-) trust boundary between the caller
+ * and callee — eg if they reside in different modules — then the wrapper factory is a useful mechanism to ensure that
+ * any business constraints defined by the callee are honoured.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_WrapperFactory">Reference guide</a>
+ */
+package org.apache.isis.applib.services.wrapper;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/xactn/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/xactn/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/xactn/package-info.java
new file mode 100644
index 0000000..d961f24
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/xactn/package-info.java
@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.xactn.TransactionService} provides a small number of methods to allow
+ * domain objects to influence user transactions.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_TransactionService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.xactn;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/services/xmlsnapshot/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/services/xmlsnapshot/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/services/xmlsnapshot/package-info.java
new file mode 100644
index 0000000..e5e2cab
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/services/xmlsnapshot/package-info.java
@@ -0,0 +1,26 @@
+/*
+ * 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.
+ */
+
+/**
+ * The {@link org.apache.isis.applib.services.xmlsnapshot.XmlSnapshotService} provides the capability to generate
+ * XML snapshots (and if required corresponding XSD schemas) based on graphs of domain objects.
+ *
+ * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_integration-api_XmlSnapshotService">Reference guide</a>
+ */
+package org.apache.isis.applib.services.xmlsnapshot;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/core/applib/src/main/java/org/apache/isis/applib/types/package-info.java
----------------------------------------------------------------------
diff --git a/core/applib/src/main/java/org/apache/isis/applib/types/package-info.java b/core/applib/src/main/java/org/apache/isis/applib/types/package-info.java
new file mode 100644
index 0000000..94f6cb4
--- /dev/null
+++ b/core/applib/src/main/java/org/apache/isis/applib/types/package-info.java
@@ -0,0 +1,23 @@
+/*
+ * 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.
+ */
+
+/**
+ *
+ */
+package org.apache.isis.applib.types;
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/example/application/simpleapp/README.adoc
----------------------------------------------------------------------
diff --git a/example/application/simpleapp/README.adoc b/example/application/simpleapp/README.adoc
index 76078b4..d52423d 100644
--- a/example/application/simpleapp/README.adoc
+++ b/example/application/simpleapp/README.adoc
@@ -202,7 +202,7 @@ mvn -Dskip.mavenmixin-isisswagger
+
[TIP]
====
-By default, Swagger spec files are generated at `target/generated-resources/isis-swagger` (in the ``webapp`` module).
+By default, Swagger schema definition files are generated at `target/generated-resources/isis-swagger` (in the ``webapp`` module).
====
* To package up the application as a docker image (specifying the docker image name as a system property): +
http://git-wip-us.apache.org/repos/asf/isis/blob/6c1d8b8b/example/archetype/simpleapp/src/main/resources/archetype-resources/README.adoc
----------------------------------------------------------------------
diff --git a/example/archetype/simpleapp/src/main/resources/archetype-resources/README.adoc b/example/archetype/simpleapp/src/main/resources/archetype-resources/README.adoc
index 5fb9fc0..c10deca 100644
--- a/example/archetype/simpleapp/src/main/resources/archetype-resources/README.adoc
+++ b/example/archetype/simpleapp/src/main/resources/archetype-resources/README.adoc
@@ -202,7 +202,7 @@ mvn -Dskip.mavenmixin-isisswagger
+
[TIP]
====
-By default, Swagger spec files are generated at `target/generated-resources/isis-swagger` (in the ``webapp`` module).
+By default, Swagger schema definition files are generated at `target/generated-resources/isis-swagger` (in the ``webapp`` module).
====
* To package up the application as a docker image: +
[7/7] isis git commit: ISIS-1521: adds TODO for cgcom post release
procedure
Posted by da...@apache.org.
ISIS-1521: adds TODO for cgcom post release procedure
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/dd0f05e1
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/dd0f05e1
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/dd0f05e1
Branch: refs/heads/master
Commit: dd0f05e16c3ae5511eb19e89a6d1e09c55c0aa6f
Parents: 3f07ea2
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Tue Aug 1 16:30:25 2017 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Tue Aug 1 16:30:25 2017 +0100
----------------------------------------------------------------------
.../cgcom/_cgcom_post-release-successful.adoc | 45 ++++----------------
1 file changed, 8 insertions(+), 37 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/dd0f05e1/adocs/documentation/src/main/asciidoc/guides/cgcom/_cgcom_post-release-successful.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/cgcom/_cgcom_post-release-successful.adoc b/adocs/documentation/src/main/asciidoc/guides/cgcom/_cgcom_post-release-successful.adoc
index 20255ad..b730f93 100644
--- a/adocs/documentation/src/main/asciidoc/guides/cgcom/_cgcom_post-release-successful.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/cgcom/_cgcom_post-release-successful.adoc
@@ -467,43 +467,21 @@ For example, if the isisaddons modules are cloned to `/c/github/isisaddons/isis-
[[__cgcom_post-release-successful_release-non-asf-modules_incode-parent]]
=== Release `incode-parent`
-The `org.incode:incode-parent` Maven module is used as a parent for both sets of modules:
-
-* update its dependency on Apache Isis to reference the newly released version: +
-+
-[source,bash]
-----
-sh bumpver_isis.sh 1.15.0
-----
-
-* update the README
-
-** replace each version with next (ie the "How to Configure/Use" section, and the "Release to Maven Central" section at the end):
-
-*** replace 1.15.0-SNAPSHOT with 1.16.0-SNAPSHOT
-*** replace 1.14.0 with 1.15.0
-
-** update the "Change Log" section
-
-* Release using: +
-+
-[source,bash]
-----
-sh release.sh "1.15.0" "1.16.0-SNAPSHOT" "dan@haywood-associates.co.uk" "this is not really my password"
-----
-
+[NOTE]
+====
+TODO: need to rework this and the following two sections to instead just release the incode-catalog (`1.15.0-SNAPSHOT`).
+This incorporates all of `incode-parent`, isisaddons.org` and `catalog.incode.org`.
+====
-[[__cgcom_post-release-successful_release-non-asf-modules_incode-mavendeps]]
-=== Release `incode-mavendeps`
-The three `org.incode:mavendeps-isisXXX` module should be released next.
+The `org.incode:incode-parent` Maven module is used as a parent for both sets of modules:
* update its dependency on Apache Isis to reference the newly released version: +
+
[source,bash]
----
-foreach -g incodehq/mavendeps sh bumpver_isis.sh 1.15.0
+sh bumpver_isis.sh 1.15.0
----
* update the README
@@ -519,14 +497,7 @@ foreach -g incodehq/mavendeps sh bumpver_isis.sh 1.15.0
+
[source,bash]
----
-foreach -g incodehq/mavendeps sh sh release.sh "1.15.0" "1.16.0-SNAPSHOT" "dan@haywood-associates.co.uk" \"this is not really my password\"
-----
-
-* update its dependency on Apache Isis to reference the next SNAPSHOT: +
-+
-[source,bash]
-----
-foreach -g incodehq/mavendeps sh bumpver_isis.sh 1.16.0-SNAPSHOT
+sh release.sh "1.15.0" "1.16.0-SNAPSHOT" "dan@haywood-associates.co.uk" "this is not really my password"
----
[6/7] isis git commit: ISIS-1676: fixes up some docs for
standardisation of use of framework-provided mixins
Posted by da...@apache.org.
ISIS-1676: fixes up some docs for standardisation of use of framework-provided mixins
nb: changes to the mixins themselves were accidentally included in an ISIS-1674 commit.
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/3f07ea2a
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/3f07ea2a
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/3f07ea2a
Branch: refs/heads/master
Commit: 3f07ea2a7c7572369c3e5fd8eb080098e612f827
Parents: 91b9cb8
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Tue Aug 1 16:24:38 2017 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Tue Aug 1 16:24:38 2017 +0100
----------------------------------------------------------------------
.../guides/rgcms/_rgcms_classes_mixins_Dto.adoc | 12 ++++++------
.../_ugfun_programming-model_mixins_inferred-name.adoc | 8 +++-----
...programming-model_mixins_nested-static-classes.adoc | 13 +++++--------
3 files changed, 14 insertions(+), 19 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/3f07ea2a/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_classes_mixins_Dto.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_classes_mixins_Dto.adoc b/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_classes_mixins_Dto.adoc
index cda020a..8d799e3 100644
--- a/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_classes_mixins_Dto.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_classes_mixins_Dto.adoc
@@ -20,15 +20,15 @@ The `Dto_downloadXml` mixin defines the following action:
[source,java]
----
-@Mixin
+@Mixin(method="act")
public class Dto_downloadXml {
public Dto_downloadXml(final Dto dto) { ... } // <1>
- public Object $$(final String fileName) { ... } // <2>
+ public Object act(final String fileName) { ... } // <2>
...
}
----
<1> provided as an action to any class that (trivially) implements the `Dto` interface
-<2> The '$$' name is a "special case", indicating the the action's name be derived from the class name.
+<2> The action's name is derived from the class name.
This will return the XML text wrapped up in a xref:../rgcms/rgcms.adoc#_rgcms_classes_value-types_Clob[`Clob`].
@@ -36,14 +36,14 @@ The `Dto_downloadXsd` mixin is similar:
[source,java]
----
-@Mixin
+@Mixin(method="act")
public class Dto_downloadXsd {
public Dto_downloadXsd(final Dto dto) { ... } // <1>
- public Object $$(final String fileName, final IsisSchemes isisSchemas) { ... } // <2>
+ public Object act(final String fileName, final IsisSchemes isisSchemas) { ... } // <2>
}
----
<1> provided as an action to any class that (trivially) implements the `Dto` interface
-<2> The '$$' name is a "special case", indicating the the action's name be derived from the class name.
+<2> The action's name be derived from the class name.
If the domain object's JAXB annotations reference only a single XSD schema then this will return that XML text as a xref:../rgcms/rgcms.adoc#_rgcms_classes_value-types_Clob[`Clob`] of that XSD.
If there are multiple XSD schemas referenced then the action will return a zip of those schemas, wrapped up in a xref:../rgcms/rgcms.adoc#_rgcms_classes_value-types_Blob[`Blob`].
http://git-wip-us.apache.org/repos/asf/isis/blob/3f07ea2a/adocs/documentation/src/main/asciidoc/guides/ugfun/_ugfun_programming-model_mixins_inferred-name.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/ugfun/_ugfun_programming-model_mixins_inferred-name.adoc b/adocs/documentation/src/main/asciidoc/guides/ugfun/_ugfun_programming-model_mixins_inferred-name.adoc
index 9306218..b84c247 100644
--- a/adocs/documentation/src/main/asciidoc/guides/ugfun/_ugfun_programming-model_mixins_inferred-name.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/ugfun/_ugfun_programming-model_mixins_inferred-name.adoc
@@ -16,7 +16,7 @@ For example:
[source,java]
----
-@Mixin
+@Mixin(method="act")
public class DocumentHolder_documents {
private final DocumentHolder holder;
@@ -25,14 +25,12 @@ public class DocumentHolder_documents {
@Action(semantics=SemanticsOf.SAFE)
@ActionLayout(contributed = Contributed.AS_ASSOCIATION)
@CollectionLayout(render = RenderType.EAGERLY)
- public List<Document> $$() { // <1>
+ public List<Document> act() {
...
}
- public boolean hide$$() { ... } // <2>
+ public boolean hideAct() { ... }
}
----
-<1> using "$$" as the reserved method name
-<2> supporting methods as usual
Alternatively, if the xref:../rgant/rgant.adoc#_rgant_Mixin_method[`@Mixin#method()`] attribute is specified, then this can nominate a different abbreviation.
http://git-wip-us.apache.org/repos/asf/isis/blob/3f07ea2a/adocs/documentation/src/main/asciidoc/guides/ugfun/_ugfun_programming-model_mixins_nested-static-classes.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/ugfun/_ugfun_programming-model_mixins_nested-static-classes.adoc b/adocs/documentation/src/main/asciidoc/guides/ugfun/_ugfun_programming-model_mixins_nested-static-classes.adoc
index 4596a2c..0dfa536 100644
--- a/adocs/documentation/src/main/asciidoc/guides/ugfun/_ugfun_programming-model_mixins_nested-static-classes.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/ugfun/_ugfun_programming-model_mixins_nested-static-classes.adoc
@@ -36,8 +36,7 @@ public class Customer {
----
<1> Prior to `1.13.2`, had to be prefixed by an "_"; this is no longer required because "$" is also recognized as a way of parsing the class name in order to infer the mixin's name (eg `Customer$placeOrder`).
<2> typically contributed to concrete class
-<3> using the "$$" reserved name
-<4> supporting methods as usual
+<3> supporting methods as usual
The mixin class can also be capitalized if desired.
@@ -48,17 +47,16 @@ Thus:
public class Customer {
@Mixin(method="act")
- public static class PlaceOrder { // <1>
-
+ public static class PlaceOrder {
private final Customer customer;
- public documents(Customer customer) { this.customer = customer; } // <2>
+ public documents(Customer customer) { this.customer = customer; }
@Action
@ActionLayout(contributed = Contributed.AS_ACTION)
- public List<Order> act(Product p, int quantity) { // <3>
+ public List<Order> act(Product p, int quantity) {
...
}
- public boolean hideAct() { ... } // <4>
+ public boolean hideAct() { ... }
public String validate0Act(Product p) { ... }
}
}
@@ -72,7 +70,6 @@ In other words, all of the following are allowed:
* `public static class _Documents { ... }`
* `public static class _documents { ... }`
-The reserved method name "$$" can also be changed using xref:../rgant/rgant.adoc#_rgant_Mixin_method[`@Mixin#method()`] or xref:../rgant/rgant.adoc#_rgant_DomainObject_mixinMethod[`@DomainObject#mixinMethod()`].
[4/7] isis git commit: ISIS-1674: comments out download link for
helloworld (reinstate once 1.15.0 is released)
Posted by da...@apache.org.
ISIS-1674: comments out download link for helloworld (reinstate once 1.15.0 is released)
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/18557bac
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/18557bac
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/18557bac
Branch: refs/heads/master
Commit: 18557bac08786c77db5948efc573dcef7a3af2fc
Parents: 6c1d8b8
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Tue Aug 1 16:20:54 2017 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Tue Aug 1 16:20:54 2017 +0100
----------------------------------------------------------------------
adocs/documentation/src/main/asciidoc/downloads.adoc | 3 +++
1 file changed, 3 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/18557bac/adocs/documentation/src/main/asciidoc/downloads.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/downloads.adoc b/adocs/documentation/src/main/asciidoc/downloads.adoc
index 5a56d3e..95eda72 100644
--- a/adocs/documentation/src/main/asciidoc/downloads.adoc
+++ b/adocs/documentation/src/main/asciidoc/downloads.adoc
@@ -27,10 +27,13 @@ Core:
* https://www.apache.org/dyn/closer.cgi/isis/isis-core/isis-1.14.0-source-release.zip[isis-1.14.0] (https://www.apache.org/dist/isis/isis-core/isis-1.14.0-source-release.zip.asc[asc], https://www.apache.org/dist/isis/isis-core/isis-1.14.0-source-release.zip.md5[md5])
+////
+commented out until 1.15.0 is released ...
HelloWorld Archetype (`1.15.0-SNAPSHOT` onwards):
* https://www.apache.org/dyn/closer.cgi/isis/archetype/helloworld-archetype/helloworld-archetype-1.14.0-source-release.zip[helloworld-archetype-1.14.0] (https://www.apache.org/dist/isis/archetype/helloworld-archetype/helloworld-archetype-1.14.0-source-release.zip.asc[asc], https://www.apache.org/dist/isis/archetype/helloworld-archetype/helloworld-archetype-1.14.0-source-release.zip.md5[md5])
+////
SimpleApp Archetype: