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