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 2015/05/15 15:36:55 UTC
[9/9] isis git commit: ISIS-1133: domain service toc.
ISIS-1133: domain service toc.
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/65d34db7
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/65d34db7
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/65d34db7
Branch: refs/heads/master
Commit: 65d34db7d41ddfad6530ae9afa617949a336f5f2
Parents: 0fd0630
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Fri May 15 14:33:17 2015 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Fri May 15 14:33:17 2015 +0100
----------------------------------------------------------------------
.../user-guide/_user-guide_reference.adoc | 12 +-
.../_user-guide_reference_addons.adoc | 17 +
...-guide_reference_addons_settings-module.adoc | 49 +++
.../_user-guide_reference_annotations.adoc | 2 +-
.../_user-guide_reference_annotations_aaa.adoc | 2 +-
.../_user-guide_reference_methods.adoc | 19 +-
.../_user-guide_reference_methods_aaa.adoc | 286 +-----------
...r-guide_reference_methods_manpage_addTo.adoc | 8 -
..._reference_methods_manpage_autoComplete.adoc | 8 -
...guide_reference_methods_manpage_choices.adoc | 8 -
...r-guide_reference_methods_manpage_clear.adoc | 8 -
...guide_reference_methods_manpage_default.adoc | 8 -
...guide_reference_methods_manpage_disable.adoc | 8 -
...ser-guide_reference_methods_manpage_get.adoc | 8 -
...er-guide_reference_methods_manpage_hide.adoc | 8 -
...-guide_reference_methods_manpage_modify.adoc | 8 -
...de_reference_methods_manpage_removeFrom.adoc | 8 -
...ser-guide_reference_methods_manpage_set.adoc | 8 -
...uide_reference_methods_manpage_validate.adoc | 8 -
...reference_methods_manpage_validateAddTo.adoc | 8 -
...ence_methods_manpage_validateRemoveFrom.adoc | 8 -
.../_user-guide_reference_mixins.adoc | 11 +
.../_user-guide_reference_prefixes.adoc | 27 ++
.../_user-guide_reference_prefixes_aaa.adoc | 151 +++++++
...-guide_reference_prefixes_manpage_addTo.adoc | 8 +
...reference_prefixes_manpage_autoComplete.adoc | 8 +
...uide_reference_prefixes_manpage_choices.adoc | 8 +
...-guide_reference_prefixes_manpage_clear.adoc | 8 +
...uide_reference_prefixes_manpage_default.adoc | 8 +
...uide_reference_prefixes_manpage_disable.adoc | 8 +
...er-guide_reference_prefixes_manpage_get.adoc | 8 +
...r-guide_reference_prefixes_manpage_hide.adoc | 8 +
...guide_reference_prefixes_manpage_modify.adoc | 8 +
...e_reference_prefixes_manpage_removeFrom.adoc | 8 +
...er-guide_reference_prefixes_manpage_set.adoc | 8 +
...ide_reference_prefixes_manpage_validate.adoc | 8 +
...eference_prefixes_manpage_validateAddTo.adoc | 8 +
...nce_prefixes_manpage_validateRemoveFrom.adoc | 8 +
.../_user-guide_reference_services.adoc | 10 +-
.../_user-guide_reference_services_aaa.adoc | 434 +++++++++++++------
...ide_reference_services_auditing-service.adoc | 2 +-
...erence_services_class-discovery-service.adoc | 8 +
...ide_reference_services_event-serializer.adoc | 8 +
...uide_reference_services_fixture-scripts.adoc | 8 +
..._reference_services_guice-bean-provider.adoc | 8 +
...ide_reference_services_settings-service.adoc | 48 --
...r-guide_reference_services_sudo-service.adoc | 8 +
47 files changed, 747 insertions(+), 587 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference.adoc
index 5508589..c4a4adc 100644
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference.adoc
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference.adoc
@@ -5,15 +5,13 @@
IMPORTANT: TODO
-include::_user-guide_reference_methods.adoc[leveloffset=+1]
-
include::_user-guide_reference_annotations.adoc[leveloffset=+1]
-
-include::_user-guide_reference_domain-services.adoc[leveloffset=+1]
-
+include::_user-guide_reference_prefixes.adoc[leveloffset=+1]
+include::_user-guide_reference_methods.adoc[leveloffset=+1]
+include::_user-guide_reference_services.adoc[leveloffset=+1]
include::_user-guide_reference_value-types.adoc[leveloffset=+1]
-
include::_user-guide_reference_applib-utility-classes.adoc[leveloffset=+1]
-
include::_user-guide_reference_convenience-superclasses.adoc[leveloffset=+1]
+include::_user-guide_reference_mixins.adoc[leveloffset=+1]
+include::_user-guide_reference_addons.adoc[leveloffset=+1]
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_addons.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_addons.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_addons.adoc
new file mode 100644
index 0000000..caa04de
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_addons.adoc
@@ -0,0 +1,17 @@
+= Isis Addons
+: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/
+
+
+This section highlights a number of the addons available at http://isisaddons.org[Isis Addons] website. Note that it is _not_ intended to be comprehensive.
+
+[NOTE]
+====
+The http://isisaddons.org[Isis Addons], while maintained by Isis committers, are entirely independent of the Apache Software Foundation.
+====
+
+
+include::_user-guide_reference_addons_settings-module.adoc[leveloffset=+1]
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_addons_settings-module.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_addons_settings-module.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_addons_settings-module.adoc
new file mode 100644
index 0000000..8355192
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_addons_settings-module.adoc
@@ -0,0 +1,49 @@
+= Settings Services
+: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 http://github.com/isisaddons/isis-module-settings}[Isis addons' settings] module provides a simple way to store both global (application-level) settings as well as per-user settings.
+
+The settings service is documented here for your convenience; the full README can be found on the http://github.com/isisaddons/isis-module-settings}[github site].
+
+
+== Application Settings
+
+=== API
+
+IMPORTANT: TODO
+
+=== Implementation
+
+In the case of `ApplicationSettingsService`, the service is implemented by `ApplicationSettingsServiceJdo`, with the `ApplicationSetting` interface implemented by a `ApplicationSettingsJdo` entity.
+
+The service also provides the ability to create list all existing settings, create new settings (of whichever datatype), update settings, and to delete settings.
+
+These actions can be hidden using security if need be.
+
+== User Settings
+
+=== API
+
+IMPORTANT: TODO
+
+=== Implementation
+
+In the case of `UserSettingsService`, the service is implemented by `UserSettingsServiceJdo`, with the `UserSetting` interface implemented by a `UserSettingsJdo` entity.
+
+As for application settings, the user settings service also provides the ability to create list all existing settings, create new settings (of whichever datatype), update settings, and to delete settings.
+
+These actions can be hidden using security if need be.
+
+
+== Registration and Configuration
+
+The `ApplicationSettingsServiceJdo` class and `UserSettingsServiceJdo` are annotated with `@DomainService` and so are automatically registered with the framework, with actions appearing on the secondary menu bar.
+
+IMPORTANT: TODO - screenshot of settings menu
+
+All actions from the services emit domain events. If you wish to hide/disable these default actions in your application, we recommend using up a subscriber on the actions' domain events to veto their visibility/usability.
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_annotations.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_annotations.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_annotations.adoc
index 2e8d7c2..d8f34bc 100644
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_annotations.adoc
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_annotations.adoc
@@ -6,7 +6,7 @@
IMPORTANT: TODO
-include::_user-guide_reference_annotations_aaa.adoc[]
+include::_user-guide_reference_annotations_aaa.adoc[leveloffset=+1]
include::_user-guide_reference_annotations_manpage_action.adoc[leveloffset=+1]
include::_user-guide_reference_annotations_manpage_actionlayout.adoc[leveloffset=+1]
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_annotations_aaa.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_annotations_aaa.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_annotations_aaa.adoc
index d086e8d..c8ef404 100644
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_annotations_aaa.adoc
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_annotations_aaa.adoc
@@ -1,4 +1,4 @@
-// = Overview
+= Summary
:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
:_basedir: ../
:_imagesdir: images/
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods.adoc
index f16ba7c..49106b3 100644
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods.adoc
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods.adoc
@@ -1,26 +1,11 @@
-= Recognized Methods
+= Reserved Methods
: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/
-include::_user-guide_reference_methods_aaa.adoc[]
-
-include::_user-guide_reference_methods_manpage_addTo.adoc[leveloffset=+1]
-include::_user-guide_reference_methods_manpage_autoComplete.adoc[leveloffset=+1]
-include::_user-guide_reference_methods_manpage_choices.adoc[leveloffset=+1]
-include::_user-guide_reference_methods_manpage_clear.adoc[leveloffset=+1]
-include::_user-guide_reference_methods_manpage_default.adoc[leveloffset=+1]
-include::_user-guide_reference_methods_manpage_disable.adoc[leveloffset=+1]
-include::_user-guide_reference_methods_manpage_get.adoc[leveloffset=+1]
-include::_user-guide_reference_methods_manpage_hide.adoc[leveloffset=+1]
-include::_user-guide_reference_methods_manpage_modify.adoc[leveloffset=+1]
-include::_user-guide_reference_methods_manpage_removeFrom.adoc[leveloffset=+1]
-include::_user-guide_reference_methods_manpage_set.adoc[leveloffset=+1]
-include::_user-guide_reference_methods_manpage_validate.adoc[leveloffset=+1]
-include::_user-guide_reference_methods_manpage_validateAddTo.adoc[leveloffset=+1]
-include::_user-guide_reference_methods_manpage_validateRemoveFrom.adoc[leveloffset=+1]
+include::_user-guide_reference_methods_aaa.adoc[leveloffset=+1]
include::_user-guide_reference_methods_manpage_cssClass.adoc[leveloffset=+1]
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_aaa.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_aaa.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_aaa.adoc
index 0c245b9..ff6d049 100644
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_aaa.adoc
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_aaa.adoc
@@ -1,218 +1,41 @@
-//= Overview
+= Summary
: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/
-== Recognized Prefixes
-
-The table below lists the method prefixes that are recognized as part of Apache Isis' default programming model.
-
-.Recognized Method Prefixes
-[cols="2,1,1,1,1,1,4a", options="header"]
-|===
-
-|Prefix
-|Object
-|Property
-|Collection
-|Action
-|Action +
-Param
-|Description
-
-|<<__code_addto_code, `addTo...()`>>
-|
-|
-|Y
-|
-|
-|add object to a collection (nb: not currently supported by Wicket viewer) +
-See also <<__code_removefrom_code, `removeFrom...()`>>`
-
-|<<__code_autocomplete_code, `autoComplete...()`>>
-|
-|Y
-|
-|
-|Y
-|Return a list of matching elements for a property or an action parameter. +
-Alternatively, can specify for a class using <<__code_domainobject_code, `@DomainObject#autoComplete`>> +
-+
-See also choices
-
-|<<__code_choices_code, `choices...()`>>
-|
-|Y
-|
-|
-|Y
-|Provide list of choices for a property or action parameter
-See also <<__code_autocomplete_code, `autoComplete...()`>>.
-
-|<<__code_clear_code, `clear...()`>>
-|
-|Y
-|
-|
-|
-|Clear a property (set it to null). Allows business logic to be placed apart from the setter.
-See also <<__code_modify_code, `modify...()`>>
-
-
-|<<__code_default_code, `default...()`>>
-|
-|Y
-|
-|
-|Y
-|Default value for a property or an action parameter.
-
-|<<__code_disable_code, `disable...()`>>
-|Y
-|Y
-|Y
-|Y
-|
-|Disables (makes read-only) a property, a collection or an action.
-
-|<<__code_get_code, `get...()`>>
-|
-|Y
-|Y
-|
-|
-|Access the value of a property or collection. +
-See also <<__code_set_code, `set...()`>>.
-
-|<<__code_hide_code, `hide...()`>>
-|
-|Y
-|Y
-|Y
-|
-|Hides a property, a collection or an action.
-
-|<<__code_modify_code, `modify...()`>>
-|
-|Y
-|
-|
-|
-|Modify a property (set it to a non-null) value. Allows business logic to be placed apart from the setter. +
-See also <<__code_clear_code, `clear...()`>>`.
-
-|<<__code_removeFrom_code, `removeFrom...()`>>
-|
-|
-|Y
-|
-|
-|remove object from a collection (nb: not currently supported by Wicket viewer) +
-See also <<__code_addto_code, `addTo...()`>>`
-
-|<<__code_set_code, `set...()`>>
-|
-|Y
-|Y
-|
-|
-|Sets the value of a property or a collection.
-
-|<<__code_validate_code, `validate...()`>>
-|Y
-|
-|
-|Y
-|Y
-|Check that a proposed value of a property or an action parameter is valid. +
-See also <<__code_validateaddto_code, validateAddTo...()`>> and <<__code_validateremovefrom_code, `validateRemoveFrom...()`>> for collections.
-
-|<<__code_validateaddto_code, `validate +
-AddTo...()`>>
-|
-|Y
-|
-|
-|
-|Check that a proposed object to add to a collection is valid. +
-See also <<__code_validateremovefrom_code, `validateRemoveFrom...()`>>, and <<__code_validate_code, `validate...()`>> for properties and collections.
-
-|<<__code_validateremovefrom_code, `validate +
-RemoveFrom...()`>>
-|
-|Y
-|
-|
-|
-|Check that a proposed object to add to a collection is valid.
-See also <<__code_validateaddto_code, `validateAddTo...()`>>, and <<__code_validate_code, `validate...()`>> for properties and collections.
-
-|===
-
-
-
-== Reserved Methods
The table below lists the reserved methods that are recognized as part of Apache Isis' default programming model.
.Reserved Methods
-[cols="2,1,1,1,1,1,4a", options="header"]
+[cols="1,4a", options="header"]
|===
|Method
-|Object
-|Property
-|Collection
-|Action
-|Action +
-Param
|Description
|<<__code_cssClass_code, `cssClass()`>>
-|Y
-|
-|
-|
-|
|Provides a CSS class for this object, which is added as a style in the containing when rendering the object within a table, or to a containing when rendering the object on a page. In conjunction with css/application.css, can therefore provide custom styling of an object instance wherever it is rendered.
See also <<__code_title_code, `title()`>> and <<__code_iconName_code, `iconName()`>>.
|<<__code_iconName_code, `iconName()`>>
-|Y
-|
-|
-|
-|
|Provides the name of the image to render, usually alongside the title, to represent the object. If not provided, then the class name is used to locate an image.
See also <<__code_title_code, `title()`>> and <<__code_cssClass_code, `cssClass()`>>
|<<__code_getId_code, `getId()`>>
|Y
-|
-|
-|
-|
|Provides an optional unique identifier of a service. +
If not provided, the services fully-qualified class name is used.
|<<__code_title_code, `title()`>>
|Y
-|
-|
-|
-|
|Provides a title for the object. +
Alternatively, use the <<__code_title_code, <<__code_@Title`>> annotation. It is also possible to use `toString_code, `@Title`>> annotation. It is also possible to use `toString()`>>. +
See also `iconName()` and <<__code_cssClass_code, `cssClass()`>>
|<<__code_toString_code, `toString()`>>
|Y
-|
-|
-|
-|
|Used as the fallback title for an object if there is no <<__code_title_code, `title()`>> method or properties annotated with the <<__code_title_code, `@Title`>> annotation.
@@ -221,7 +44,6 @@ See also `iconName()` and <<__code_cssClass_code, `cssClass()`>>
-== Lifecycle callback methods
The lifecycle callback methods notify a domain entity about its interaction within the persistence lifecycle. For example, the entity is notified immediately prior to being persisted, or when it is about to be updated.
@@ -235,82 +57,35 @@ As an alternative, consider using Isis' event bus and domain events.
The lifecycle methods are:
.Lifecycle methods (partial support)
-[cols="2,1,1,1,1,1,4a", options="header"]
+[cols="1,4a", options="header"]
|===
-|Prefix
-|Object
-|Property
-|Collection
-|Action
-|Action +
-Param
+|Method
|Description
|<<__code_created_code, `created()`>>
-|Y
-|
-|
-|
-|
-|Lifecycle callback for when the object has just been created using <<__code_newTransientInstance_code, `newTransientInstance()`>>
+|called when an object has just been created using <<__code_newTransientInstance_code, `newTransientInstance()`>>
|<<__code_loaded_code, `loaded()`>>
-|Y
-|
-|
-|
-|
-|Lifecycle callback for when the (persistent) object has just been loaded from the object store.
+|called when a (persistent) object has just been loaded from the object store.
|<<__code_persisted_code, `persisted()`>>
-|Y
-|
-|
-|
-|
-|Lifecycle callback for when the (persistent) object has just been persisted from the object store.
+|called when object has just been persisted from the object store.
|<<__code_persisting_code, `persisting()`>>
-|Y
-|
-|
-|
-|
-|Lifecycle callback for when the (persistent) object is just about to be persisted from the object store
-
+|called when a (not-yet-persistent) object is just about to be persisted from the object store
|<<__code_removed_code, `removed()`>>
-|Y
-|
-|
-|
-|
-|Lifecycle callback for when the (persistent) object has just been persisted from the object store
+|called when a (persistent) object has just been persisted from the object store
|<<__code_removing_code, `removing()`>>
-|Y
-|
-|
-|
-|
-|Lifecycle callback for when the (persistent) object is just about to be deleted from the object store
+|called when a (persistent) object is just about to be deleted from the object store
|<<__code_updated_code, `updated()`>>
-|Y
-|
-|
-|
-|
-|Lifecycle callback for when the (persistent) object has just been updated in the object store
+|called when a (persistent) object has just been updated in the object store
|<<__code_updating_code, `updating()`>>
-|Y
-|
-|
-|
-|
-|Lifecycle callback for when the (persistent) object is just about to be updated in the object store
+|called when a (persistent) object is just about to be updated in the object store
|===
@@ -319,39 +94,20 @@ Param
Some lifecycle methods have been deprecated:
.Deprecated lifecycle methods
-[cols="2,1,1,1,1,1,4a", options="header"]
+[cols="1,4a", options="header"]
|===
-Prefix
-|Object
-|Property
-|Collection
-|Action
-|Action Param
-|See also
+
+|Method
+|Notes
|<<__code_deleted_code, `deleted()`>>
-|Y
-|
-|
-|
-|
|Replaced by <<__code_removed_code, `removed()`>>
|<<__code_deleting_code, `deleting()`>>
-|Y
-|
-|
-|
-|
|Replaced by removing()`
|`loading`
-|Y
-|
-|
-|
-|
-|Lifecycle callback for when the (persistent) object is just about to be loaded from the object store. +
+|callback for when the (persistent) object is just about to be loaded from the object store. +
[WARNING]
====
This method is never called.
@@ -359,18 +115,10 @@ This method is never called.
|<<__code_saved_code, `saved()`>>
|Y
-|
-|
-|
-|
|Replaced by persisted()`
|<<__code_saving_code, `saving()`>>
|Y
-|
-|
-|
-|
|Replaced by <<__code_persisting_code, `persisting()`>>
|===
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_addTo.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_addTo.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_addTo.adoc
deleted file mode 100644
index 73a8ebb..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_addTo.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `addTo...()`
-: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/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_autoComplete.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_autoComplete.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_autoComplete.adoc
deleted file mode 100644
index 1b4cfd1..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_autoComplete.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `autoComplete...()`
-: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/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_choices.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_choices.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_choices.adoc
deleted file mode 100644
index 4406b14..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_choices.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `choices...()`
-: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/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_clear.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_clear.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_clear.adoc
deleted file mode 100644
index a84aafc..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_clear.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `clear...()`
-: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/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_default.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_default.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_default.adoc
deleted file mode 100644
index 92f1658..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_default.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `default...()`
-: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/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_disable.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_disable.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_disable.adoc
deleted file mode 100644
index b511df5..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_disable.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `disable...()`
-: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/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_get.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_get.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_get.adoc
deleted file mode 100644
index a2f9f87..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_get.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `get...()`
-: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/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_hide.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_hide.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_hide.adoc
deleted file mode 100644
index 8918811..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_hide.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `hide...()`
-: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/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_modify.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_modify.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_modify.adoc
deleted file mode 100644
index acd087d..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_modify.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `modify...()`
-: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/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_removeFrom.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_removeFrom.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_removeFrom.adoc
deleted file mode 100644
index 14411ba..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_removeFrom.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `removeFrom...()`
-: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/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_set.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_set.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_set.adoc
deleted file mode 100644
index add8f0e..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_set.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `set...()`
-: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/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_validate.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_validate.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_validate.adoc
deleted file mode 100644
index 3135322..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_validate.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `validate...()`
-: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/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_validateAddTo.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_validateAddTo.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_validateAddTo.adoc
deleted file mode 100644
index fa98e27..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_validateAddTo.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `validateAddTo...()`
-: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/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_validateRemoveFrom.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_validateRemoveFrom.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_validateRemoveFrom.adoc
deleted file mode 100644
index 0cb8353..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_manpage_validateRemoveFrom.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= `validateRemoveFrom...()`
-: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/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_mixins.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_mixins.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_mixins.adoc
new file mode 100644
index 0000000..13634f8
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_mixins.adoc
@@ -0,0 +1,11 @@
+= Mixins
+: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/
+
+
+IMPORTANT: TODO
+
+== `HasTransactionId`
+
+== `HasUsername`
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes.adoc
new file mode 100644
index 0000000..2cd4338
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes.adoc
@@ -0,0 +1,27 @@
+= Recognized Method Prefixes
+: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/
+
+
+
+include::_user-guide_reference_prefixes_aaa.adoc[leveloffset=+1]
+
+include::_user-guide_reference_prefixes_manpage_addTo.adoc[leveloffset=+1]
+include::_user-guide_reference_prefixes_manpage_autoComplete.adoc[leveloffset=+1]
+include::_user-guide_reference_prefixes_manpage_choices.adoc[leveloffset=+1]
+include::_user-guide_reference_prefixes_manpage_clear.adoc[leveloffset=+1]
+include::_user-guide_reference_prefixes_manpage_default.adoc[leveloffset=+1]
+include::_user-guide_reference_prefixes_manpage_disable.adoc[leveloffset=+1]
+include::_user-guide_reference_prefixes_manpage_get.adoc[leveloffset=+1]
+include::_user-guide_reference_prefixes_manpage_hide.adoc[leveloffset=+1]
+include::_user-guide_reference_prefixes_manpage_modify.adoc[leveloffset=+1]
+include::_user-guide_reference_prefixes_manpage_removeFrom.adoc[leveloffset=+1]
+include::_user-guide_reference_prefixes_manpage_set.adoc[leveloffset=+1]
+include::_user-guide_reference_prefixes_manpage_validate.adoc[leveloffset=+1]
+include::_user-guide_reference_prefixes_manpage_validateAddTo.adoc[leveloffset=+1]
+include::_user-guide_reference_prefixes_manpage_validateRemoveFrom.adoc[leveloffset=+1]
+
+
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_aaa.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_aaa.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_aaa.adoc
new file mode 100644
index 0000000..ea45d56
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_aaa.adoc
@@ -0,0 +1,151 @@
+= Summary
+: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 table below lists the method prefixes that are recognized as part of Apache Isis' default programming model.
+
+.Recognized Method Prefixes
+[cols="2,1,1,1,1,1,4a", options="header"]
+|===
+
+|Prefix
+|Object
+|Property
+|Collection
+|Action
+|Action +
+Param
+|Description
+
+|<<__code_addto_code, `addTo...()`>>
+|
+|
+|Y
+|
+|
+|add object to a collection (nb: not currently supported by Wicket viewer) +
+See also <<__code_removefrom_code, `removeFrom...()`>>`
+
+|<<__code_autocomplete_code, `autoComplete...()`>>
+|
+|Y
+|
+|
+|Y
+|Return a list of matching elements for a property or an action parameter. +
+Alternatively, can specify for a class using <<__code_domainobject_code, `@DomainObject#autoComplete`>> +
++
+See also choices
+
+|<<__code_choices_code, `choices...()`>>
+|
+|Y
+|
+|
+|Y
+|Provide list of choices for a property or action parameter
+See also <<__code_autocomplete_code, `autoComplete...()`>>.
+
+|<<__code_clear_code, `clear...()`>>
+|
+|Y
+|
+|
+|
+|Clear a property (set it to null). Allows business logic to be placed apart from the setter.
+See also <<__code_modify_code, `modify...()`>>
+
+
+|<<__code_default_code, `default...()`>>
+|
+|Y
+|
+|
+|Y
+|Default value for a property or an action parameter.
+
+|<<__code_disable_code, `disable...()`>>
+|Y
+|Y
+|Y
+|Y
+|
+|Disables (makes read-only) a property, a collection or an action.
+
+|<<__code_get_code, `get...()`>>
+|
+|Y
+|Y
+|
+|
+|Access the value of a property or collection. +
+See also <<__code_set_code, `set...()`>>.
+
+|<<__code_hide_code, `hide...()`>>
+|
+|Y
+|Y
+|Y
+|
+|Hides a property, a collection or an action.
+
+|<<__code_modify_code, `modify...()`>>
+|
+|Y
+|
+|
+|
+|Modify a property (set it to a non-null) value. Allows business logic to be placed apart from the setter. +
+See also <<__code_clear_code, `clear...()`>>`.
+
+|<<__code_removeFrom_code, `removeFrom...()`>>
+|
+|
+|Y
+|
+|
+|remove object from a collection (nb: not currently supported by Wicket viewer) +
+See also <<__code_addto_code, `addTo...()`>>`
+
+|<<__code_set_code, `set...()`>>
+|
+|Y
+|Y
+|
+|
+|Sets the value of a property or a collection.
+
+|<<__code_validate_code, `validate...()`>>
+|Y
+|
+|
+|Y
+|Y
+|Check that a proposed value of a property or an action parameter is valid. +
+See also <<__code_validateaddto_code, validateAddTo...()`>> and <<__code_validateremovefrom_code, `validateRemoveFrom...()`>> for collections.
+
+|<<__code_validateaddto_code, `validate +
+AddTo...()`>>
+|
+|Y
+|
+|
+|
+|Check that a proposed object to add to a collection is valid. +
+See also <<__code_validateremovefrom_code, `validateRemoveFrom...()`>>, and <<__code_validate_code, `validate...()`>> for properties and collections.
+
+|<<__code_validateremovefrom_code, `validate +
+RemoveFrom...()`>>
+|
+|Y
+|
+|
+|
+|Check that a proposed object to add to a collection is valid.
+See also <<__code_validateaddto_code, `validateAddTo...()`>>, and <<__code_validate_code, `validate...()`>> for properties and collections.
+
+|===
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_addTo.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_addTo.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_addTo.adoc
new file mode 100644
index 0000000..73a8ebb
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_addTo.adoc
@@ -0,0 +1,8 @@
+= `addTo...()`
+: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/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_autoComplete.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_autoComplete.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_autoComplete.adoc
new file mode 100644
index 0000000..1b4cfd1
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_autoComplete.adoc
@@ -0,0 +1,8 @@
+= `autoComplete...()`
+: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/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_choices.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_choices.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_choices.adoc
new file mode 100644
index 0000000..4406b14
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_choices.adoc
@@ -0,0 +1,8 @@
+= `choices...()`
+: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/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_clear.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_clear.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_clear.adoc
new file mode 100644
index 0000000..a84aafc
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_clear.adoc
@@ -0,0 +1,8 @@
+= `clear...()`
+: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/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_default.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_default.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_default.adoc
new file mode 100644
index 0000000..92f1658
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_default.adoc
@@ -0,0 +1,8 @@
+= `default...()`
+: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/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_disable.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_disable.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_disable.adoc
new file mode 100644
index 0000000..b511df5
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_disable.adoc
@@ -0,0 +1,8 @@
+= `disable...()`
+: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/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_get.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_get.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_get.adoc
new file mode 100644
index 0000000..a2f9f87
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_get.adoc
@@ -0,0 +1,8 @@
+= `get...()`
+: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/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_hide.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_hide.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_hide.adoc
new file mode 100644
index 0000000..8918811
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_hide.adoc
@@ -0,0 +1,8 @@
+= `hide...()`
+: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/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_modify.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_modify.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_modify.adoc
new file mode 100644
index 0000000..acd087d
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_modify.adoc
@@ -0,0 +1,8 @@
+= `modify...()`
+: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/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_removeFrom.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_removeFrom.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_removeFrom.adoc
new file mode 100644
index 0000000..14411ba
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_removeFrom.adoc
@@ -0,0 +1,8 @@
+= `removeFrom...()`
+: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/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_set.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_set.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_set.adoc
new file mode 100644
index 0000000..add8f0e
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_set.adoc
@@ -0,0 +1,8 @@
+= `set...()`
+: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/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_validate.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_validate.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_validate.adoc
new file mode 100644
index 0000000..3135322
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_validate.adoc
@@ -0,0 +1,8 @@
+= `validate...()`
+: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/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_validateAddTo.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_validateAddTo.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_validateAddTo.adoc
new file mode 100644
index 0000000..fa98e27
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_validateAddTo.adoc
@@ -0,0 +1,8 @@
+= `validateAddTo...()`
+: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/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_validateRemoveFrom.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_validateRemoveFrom.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_validateRemoveFrom.adoc
new file mode 100644
index 0000000..0cb8353
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_prefixes_manpage_validateRemoveFrom.adoc
@@ -0,0 +1,8 @@
+= `validateRemoveFrom...()`
+: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/
+
+IMPORTANT: TODO
+
+
http://git-wip-us.apache.org/repos/asf/isis/blob/65d34db7/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services.adoc
index 8dfe616..e4eff00 100644
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services.adoc
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services.adoc
@@ -6,13 +6,14 @@
IMPORTANT: TODO
-include::_user-guide_reference_services_aaa.adoc[]
+include::_user-guide_reference_services_aaa.adoc[leveloffset=+1]
include::_user-guide_reference_services_action-invocation-context.adoc[leveloffset=+1]
include::_user-guide_reference_services_auditing-service.adoc[leveloffset=+1]
include::_user-guide_reference_services_background-command-service.adoc[leveloffset=+1]
include::_user-guide_reference_services_background-service.adoc[leveloffset=+1]
include::_user-guide_reference_services_bookmark-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services_class-discovery-service.adoc[leveloffset=+1]
include::_user-guide_reference_services_clock-service.adoc[leveloffset=+1]
include::_user-guide_reference_services_command-context.adoc[leveloffset=+1]
include::_user-guide_reference_services_command-service.adoc[leveloffset=+1]
@@ -23,7 +24,10 @@ include::_user-guide_reference_services_domain-object-container.adoc[leveloffset
include::_user-guide_reference_services_email-notification-service.adoc[leveloffset=+1]
include::_user-guide_reference_services_email-service.adoc[leveloffset=+1]
include::_user-guide_reference_services_event-bus-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services_event-serializer.adoc[leveloffset=+1]
include::_user-guide_reference_services_exception-recognizer.adoc[leveloffset=+1]
+include::_user-guide_reference_services_fixture-scripts.adoc[leveloffset=+1]
+include::_user-guide_reference_services_guice-bean-provider.adoc[leveloffset=+1]
include::_user-guide_reference_services_isis-jdo-support.adoc[leveloffset=+1]
include::_user-guide_reference_services_locale-provider.adoc[leveloffset=+1]
include::_user-guide_reference_services_memento-service.adoc[leveloffset=+1]
@@ -31,7 +35,7 @@ include::_user-guide_reference_services_metamodel-service.adoc[leveloffset=+1]
include::_user-guide_reference_services_publishing-service.adoc[leveloffset=+1]
include::_user-guide_reference_services_query-results-cache.adoc[leveloffset=+1]
include::_user-guide_reference_services_scratch-pad.adoc[leveloffset=+1]
-include::_user-guide_reference_services_settings-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services_sudo-service.adoc[leveloffset=+1]
include::_user-guide_reference_services_translation-service.adoc[leveloffset=+1]
include::_user-guide_reference_services_translations-resolver.adoc[leveloffset=+1]
include::_user-guide_reference_services_user-profile-service.adoc[leveloffset=+1]
@@ -39,5 +43,3 @@ include::_user-guide_reference_services_user-registration-service.adoc[leveloffs
include::_user-guide_reference_services_wrapper-factory.adoc[leveloffset=+1]
include::_user-guide_reference_services_xml-snapshot-service.adoc[leveloffset=+1]
-
-