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:36 UTC
[3/7] isis git commit: ISIS-1685: adds missing package-info.java for
applib
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;