You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by mg...@apache.org on 2015/12/13 15:31:18 UTC
[11/52] [abbrv] isis git commit: ISIS-1243: renamed rg.adoc to
rgcms.adoc
ISIS-1243: renamed rg.adoc to rgcms.adoc
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/d0539e43
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/d0539e43
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/d0539e43
Branch: refs/heads/ISIS-1224-select2-v4
Commit: d0539e43feafd9fef12bc826962ab8a82234efdd
Parents: 1409af2
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Thu Dec 3 17:27:06 2015 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Thu Dec 3 17:27:06 2015 +0000
----------------------------------------------------------------------
.../_migration-notes_1.10.0-to-1.11.0.adoc | 2 +-
...o-1.9.0_bootstrapping-using-AppManifest.adoc | 2 +-
..._fixture-scripts-specification-provider.adoc | 2 +-
...1.8.0-to-1.9.0_specify-all-dom-packages.adoc | 2 +-
.../src/main/asciidoc/documentation.adoc | 2 +-
.../asciidoc/guides/_cg_asciidoc-templates.adoc | 28 +-
.../asciidoc/guides/_cg_isis-maven-plugin.adoc | 6 +-
.../guides/_cg_isis-maven-plugin_xsd.adoc | 8 +-
.../src/main/asciidoc/guides/_rg_classes.adoc | 23 --
.../_rg_classes_AppManifest-bootstrapping.adoc | 282 -------------------
.../guides/_rg_classes_contributee.adoc | 13 -
...es_contributee_manpage-HasTransactionId.adoc | 31 --
...classes_contributee_manpage-HasUserName.adoc | 27 --
.../guides/_rg_classes_domainevent.adoc | 76 -----
...domainevent_manpage-AbstractDomainEvent.adoc | 20 --
...s_domainevent_manpage-ActionDomainEvent.adoc | 20 --
...mainevent_manpage-CollectionDomainEvent.adoc | 21 --
...domainevent_manpage-PropertyDomainEvent.adoc | 17 --
.../main/asciidoc/guides/_rg_classes_i18n.adoc | 11 -
...classes_i18n_manpage-TranslatableString.adoc | 13 -
.../guides/_rg_classes_lifecycleevent.adoc | 130 ---------
...cleevent_manpage-AbstractLifecycleEvent.adoc | 27 --
...fecycleevent_manpage-ObjectCreatedEvent.adoc | 20 --
...ifecycleevent_manpage-ObjectLoadedEvent.adoc | 17 --
...cycleevent_manpage-ObjectPersistedEvent.adoc | 19 --
...ycleevent_manpage-ObjectPersistingEvent.adoc | 21 --
...ecycleevent_manpage-ObjectRemovingEvent.adoc | 20 --
...fecycleevent_manpage-ObjectUpdatedEvent.adoc | 21 --
...ecycleevent_manpage-ObjectUpdatingEvent.adoc | 22 --
.../main/asciidoc/guides/_rg_classes_roles.adoc | 18 --
.../guides/_rg_classes_roles_manpage-Dto.adoc | 61 ----
...rg_classes_roles_manpage-HoldsUpdatedAt.adoc | 44 ---
...rg_classes_roles_manpage-HoldsUpdatedBy.adoc | 19 --
.../_rg_classes_roles_manpage-Persistable.adoc | 34 ---
..._rg_classes_roles_manpage-Timestampable.adoc | 23 --
.../main/asciidoc/guides/_rg_classes_spec.adoc | 108 -------
.../main/asciidoc/guides/_rg_classes_super.adoc | 105 -------
...s_super_manpage-AbstractContainedObject.adoc | 32 ---
...sses_super_manpage-AbstractDomainObject.adoc | 14 -
...er_manpage-AbstractFactoryAndRepository.adoc | 15 -
...g_classes_super_manpage-AbstractService.adoc | 10 -
...lasses_super_manpage-AbstractSubscriber.adoc | 18 --
...classes_super_manpage-AbstractViewModel.adoc | 15 -
..._rg_classes_super_manpage-FixtureScript.adoc | 21 --
...rg_classes_super_manpage-FixtureScripts.adoc | 12 -
.../asciidoc/guides/_rg_classes_uievent.adoc | 62 ----
...classes_uievent_manpage-CssClassUiEvent.adoc | 22 --
..._rg_classes_uievent_manpage-IconUiEvent.adoc | 23 --
...rg_classes_uievent_manpage-TitleUiEvent.adoc | 22 --
.../asciidoc/guides/_rg_classes_utility.adoc | 16 --
.../_rg_classes_utility_manpage-Enums.adoc | 8 -
...classes_utility_manpage-ObjectContracts.adoc | 107 -------
.../_rg_classes_utility_manpage-Reasons.adoc | 31 --
..._rg_classes_utility_manpage-TitleBuffer.adoc | 13 -
.../guides/_rg_classes_value-types.adoc | 119 --------
.../_rg_classes_value-types_manpage-Blob.adoc | 8 -
.../_rg_classes_value-types_manpage-Clob.adoc | 8 -
.../_rg_classes_value-types_manpage-Color.adoc | 8 -
.../_rg_classes_value-types_manpage-Money.adoc | 8 -
...rg_classes_value-types_manpage-Password.adoc | 8 -
.../src/main/asciidoc/guides/_rg_methods.adoc | 17 --
.../asciidoc/guides/_rg_methods_lifecycle.adoc | 102 -------
.../guides/_rg_methods_lifecycle_jdo-api.adoc | 53 ----
.../_rg_methods_lifecycle_manpage-created.adoc | 17 --
.../_rg_methods_lifecycle_manpage-loaded.adoc | 15 -
..._rg_methods_lifecycle_manpage-persisted.adoc | 16 --
...rg_methods_lifecycle_manpage-persisting.adoc | 16 --
.../_rg_methods_lifecycle_manpage-removed.adoc | 16 --
.../_rg_methods_lifecycle_manpage-removing.adoc | 16 --
.../_rg_methods_lifecycle_manpage-updated.adoc | 18 --
.../_rg_methods_lifecycle_manpage-updating.adoc | 15 -
.../asciidoc/guides/_rg_methods_prefixes.adoc | 219 --------------
.../_rg_methods_prefixes_manpage-addTo.adoc | 37 ---
...g_methods_prefixes_manpage-autoComplete.adoc | 96 -------
.../_rg_methods_prefixes_manpage-choices.adoc | 143 ----------
.../_rg_methods_prefixes_manpage-clear.adoc | 32 ---
.../_rg_methods_prefixes_manpage-default.adoc | 129 ---------
.../_rg_methods_prefixes_manpage-disable.adoc | 93 ------
.../_rg_methods_prefixes_manpage-get.adoc | 19 --
.../_rg_methods_prefixes_manpage-hide.adoc | 82 ------
.../_rg_methods_prefixes_manpage-modify.adoc | 37 ---
..._rg_methods_prefixes_manpage-removeFrom.adoc | 37 ---
.../_rg_methods_prefixes_manpage-set.adoc | 13 -
.../_rg_methods_prefixes_manpage-validate.adoc | 113 --------
..._methods_prefixes_manpage-validateAddTo.adoc | 45 ---
...ods_prefixes_manpage-validateRemoveFrom.adoc | 45 ---
.../asciidoc/guides/_rg_methods_reserved.adoc | 58 ----
.../_rg_methods_reserved_manpage-cssClass.adoc | 46 ---
.../_rg_methods_reserved_manpage-disable.adoc | 102 -------
.../_rg_methods_reserved_manpage-getId.adoc | 19 --
.../_rg_methods_reserved_manpage-hide.adoc | 39 ---
.../_rg_methods_reserved_manpage-iconName.adoc | 36 ---
.../_rg_methods_reserved_manpage-title.adoc | 65 -----
.../_rg_methods_reserved_manpage-validate.adoc | 27 --
.../main/asciidoc/guides/_rg_schema-aim.adoc | 97 -------
.../main/asciidoc/guides/_rg_schema-common.adoc | 103 -------
.../src/main/asciidoc/guides/_rg_schema.adoc | 24 --
.../guides/_rgant-Collection_editing.adoc | 2 +-
.../src/main/asciidoc/guides/_rgant-Column.adoc | 2 +-
.../_rgant-DomainObjectLayout_cssClassFa.adoc | 2 +-
...gant-DomainObjectLayout_cssClassUiEvent.adoc | 2 +-
.../_rgant-DomainObjectLayout_iconUiEvent.adoc | 2 +-
.../_rgant-DomainObjectLayout_titleUiEvent.adoc | 2 +-
...ant-DomainObject_autoCompleteRepository.adoc | 2 +-
.../guides/_rgant-DomainObject_bounded.adoc | 2 +-
.../guides/_rgant-DomainObject_nature.adoc | 2 +-
...t-DomainObject_persistingLifecycleEvent.adoc | 2 +-
...ant-DomainObject_removingLifecycleEvent.adoc | 2 +-
...ant-DomainObject_updatingLifecycleEvent.adoc | 2 +-
.../main/asciidoc/guides/_rgant-MinLength.adoc | 2 +-
.../main/asciidoc/guides/_rgant-Parameter.adoc | 2 +-
.../asciidoc/guides/_rgant-PostConstruct.adoc | 2 +-
.../main/asciidoc/guides/_rgant-PreDestroy.adoc | 2 +-
.../guides/_rgant-Property_editing.adoc | 2 +-
.../_rgant-ViewModelLayout_cssClassFa.adoc | 2 +-
.../asciidoc/guides/_rgant-XmlRootElement.adoc | 6 +-
.../guides/_rgcfg_configuring-core.adoc | 4 +-
...s_disabling-persistence-by-reachability.adoc | 2 +-
...atanucleus_eagerly-registering-entities.adoc | 2 +-
...gcfg_configuring-datanucleus_properties.adoc | 2 +-
.../guides/_rgcfg_specifying-components.adoc | 8 +-
.../main/asciidoc/guides/_rgcms_classes.adoc | 23 ++
...rgcms_classes_AppManifest-bootstrapping.adoc | 282 +++++++++++++++++++
.../guides/_rgcms_classes_contributee.adoc | 13 +
...es_contributee_manpage-HasTransactionId.adoc | 31 ++
...classes_contributee_manpage-HasUserName.adoc | 27 ++
.../guides/_rgcms_classes_domainevent.adoc | 76 +++++
...domainevent_manpage-AbstractDomainEvent.adoc | 20 ++
...s_domainevent_manpage-ActionDomainEvent.adoc | 20 ++
...mainevent_manpage-CollectionDomainEvent.adoc | 21 ++
...domainevent_manpage-PropertyDomainEvent.adoc | 17 ++
.../asciidoc/guides/_rgcms_classes_i18n.adoc | 11 +
...classes_i18n_manpage-TranslatableString.adoc | 13 +
.../guides/_rgcms_classes_lifecycleevent.adoc | 130 +++++++++
...cleevent_manpage-AbstractLifecycleEvent.adoc | 27 ++
...fecycleevent_manpage-ObjectCreatedEvent.adoc | 20 ++
...ifecycleevent_manpage-ObjectLoadedEvent.adoc | 17 ++
...cycleevent_manpage-ObjectPersistedEvent.adoc | 19 ++
...ycleevent_manpage-ObjectPersistingEvent.adoc | 21 ++
...ecycleevent_manpage-ObjectRemovingEvent.adoc | 20 ++
...fecycleevent_manpage-ObjectUpdatedEvent.adoc | 21 ++
...ecycleevent_manpage-ObjectUpdatingEvent.adoc | 22 ++
.../asciidoc/guides/_rgcms_classes_roles.adoc | 18 ++
.../_rgcms_classes_roles_manpage-Dto.adoc | 61 ++++
...ms_classes_roles_manpage-HoldsUpdatedAt.adoc | 44 +++
...ms_classes_roles_manpage-HoldsUpdatedBy.adoc | 19 ++
...rgcms_classes_roles_manpage-Persistable.adoc | 34 +++
...cms_classes_roles_manpage-Timestampable.adoc | 23 ++
.../asciidoc/guides/_rgcms_classes_spec.adoc | 108 +++++++
.../asciidoc/guides/_rgcms_classes_super.adoc | 105 +++++++
...s_super_manpage-AbstractContainedObject.adoc | 32 +++
...sses_super_manpage-AbstractDomainObject.adoc | 14 +
...er_manpage-AbstractFactoryAndRepository.adoc | 15 +
...s_classes_super_manpage-AbstractService.adoc | 10 +
...lasses_super_manpage-AbstractSubscriber.adoc | 18 ++
...classes_super_manpage-AbstractViewModel.adoc | 15 +
...cms_classes_super_manpage-FixtureScript.adoc | 21 ++
...ms_classes_super_manpage-FixtureScripts.adoc | 12 +
.../asciidoc/guides/_rgcms_classes_uievent.adoc | 62 ++++
...classes_uievent_manpage-CssClassUiEvent.adoc | 22 ++
...cms_classes_uievent_manpage-IconUiEvent.adoc | 23 ++
...ms_classes_uievent_manpage-TitleUiEvent.adoc | 22 ++
.../asciidoc/guides/_rgcms_classes_utility.adoc | 16 ++
.../_rgcms_classes_utility_manpage-Enums.adoc | 8 +
...classes_utility_manpage-ObjectContracts.adoc | 107 +++++++
.../_rgcms_classes_utility_manpage-Reasons.adoc | 31 ++
...cms_classes_utility_manpage-TitleBuffer.adoc | 13 +
.../guides/_rgcms_classes_value-types.adoc | 119 ++++++++
..._rgcms_classes_value-types_manpage-Blob.adoc | 8 +
..._rgcms_classes_value-types_manpage-Clob.adoc | 8 +
...rgcms_classes_value-types_manpage-Color.adoc | 8 +
...rgcms_classes_value-types_manpage-Money.adoc | 8 +
...ms_classes_value-types_manpage-Password.adoc | 8 +
.../main/asciidoc/guides/_rgcms_methods.adoc | 17 ++
.../guides/_rgcms_methods_lifecycle.adoc | 102 +++++++
.../_rgcms_methods_lifecycle_jdo-api.adoc | 53 ++++
...rgcms_methods_lifecycle_manpage-created.adoc | 17 ++
..._rgcms_methods_lifecycle_manpage-loaded.adoc | 15 +
...cms_methods_lifecycle_manpage-persisted.adoc | 16 ++
...ms_methods_lifecycle_manpage-persisting.adoc | 16 ++
...rgcms_methods_lifecycle_manpage-removed.adoc | 16 ++
...gcms_methods_lifecycle_manpage-removing.adoc | 16 ++
...rgcms_methods_lifecycle_manpage-updated.adoc | 18 ++
...gcms_methods_lifecycle_manpage-updating.adoc | 15 +
.../guides/_rgcms_methods_prefixes.adoc | 219 ++++++++++++++
.../_rgcms_methods_prefixes_manpage-addTo.adoc | 37 +++
...s_methods_prefixes_manpage-autoComplete.adoc | 96 +++++++
..._rgcms_methods_prefixes_manpage-choices.adoc | 143 ++++++++++
.../_rgcms_methods_prefixes_manpage-clear.adoc | 32 +++
..._rgcms_methods_prefixes_manpage-default.adoc | 129 +++++++++
..._rgcms_methods_prefixes_manpage-disable.adoc | 93 ++++++
.../_rgcms_methods_prefixes_manpage-get.adoc | 19 ++
.../_rgcms_methods_prefixes_manpage-hide.adoc | 82 ++++++
.../_rgcms_methods_prefixes_manpage-modify.adoc | 37 +++
...cms_methods_prefixes_manpage-removeFrom.adoc | 37 +++
.../_rgcms_methods_prefixes_manpage-set.adoc | 13 +
...rgcms_methods_prefixes_manpage-validate.adoc | 113 ++++++++
..._methods_prefixes_manpage-validateAddTo.adoc | 45 +++
...ods_prefixes_manpage-validateRemoveFrom.adoc | 45 +++
.../guides/_rgcms_methods_reserved.adoc | 58 ++++
...rgcms_methods_reserved_manpage-cssClass.adoc | 46 +++
..._rgcms_methods_reserved_manpage-disable.adoc | 102 +++++++
.../_rgcms_methods_reserved_manpage-getId.adoc | 19 ++
.../_rgcms_methods_reserved_manpage-hide.adoc | 39 +++
...rgcms_methods_reserved_manpage-iconName.adoc | 36 +++
.../_rgcms_methods_reserved_manpage-title.adoc | 65 +++++
...rgcms_methods_reserved_manpage-validate.adoc | 27 ++
.../main/asciidoc/guides/_rgcms_schema-aim.adoc | 97 +++++++
.../asciidoc/guides/_rgcms_schema-common.adoc | 103 +++++++
.../src/main/asciidoc/guides/_rgcms_schema.adoc | 24 ++
.../src/main/asciidoc/guides/_rgsvc-api.adoc | 4 +-
.../_rgsvc-api_ActionInvocationContext.adoc | 2 +-
.../guides/_rgsvc-api_BackgroundService.adoc | 2 +-
.../guides/_rgsvc-api_BookmarkService.adoc | 2 +-
.../guides/_rgsvc-api_ClockService.adoc | 2 +-
.../guides/_rgsvc-api_CommandContext.adoc | 2 +-
.../guides/_rgsvc-api_DeepLinkService.adoc | 2 +-
.../_rgsvc-api_DomainObjectContainer.adoc | 2 +-
...mainObjectContainer_object-creation-api.adoc | 6 +-
..._DomainObjectContainer_presentation-api.adoc | 2 +-
...pi_DomainObjectContainer_validation-api.adoc | 4 +-
.../guides/_rgsvc-api_EmailService.adoc | 2 +-
.../guides/_rgsvc-api_EventBusService.adoc | 6 +-
.../_rgsvc-api_FixtureScriptsDefault.adoc | 6 +-
.../guides/_rgsvc-api_GuiceBeanProvider.adoc | 2 +-
.../guides/_rgsvc-api_IsisJdoSupport.adoc | 2 +-
.../asciidoc/guides/_rgsvc-api_JaxbService.adoc | 6 +-
.../guides/_rgsvc-api_MementoService.adoc | 4 +-
.../guides/_rgsvc-api_MetamodelService.adoc | 2 +-
.../guides/_rgsvc-api_QueryResultsCache.adoc | 2 +-
.../asciidoc/guides/_rgsvc-api_Scratchpad.adoc | 2 +-
.../asciidoc/guides/_rgsvc-api_SudoService.adoc | 2 +-
.../guides/_rgsvc-api_WrapperFactory.adoc | 6 +-
.../guides/_rgsvc-api_XmlSnapshotService.adoc | 2 +-
.../src/main/asciidoc/guides/_rgsvc-spi.adoc | 2 +-
.../guides/_rgsvc-spi_AuditingService.adoc | 6 +-
.../_rgsvc-spi_BackgroundCommandService.adoc | 2 +-
.../_rgsvc-spi_ClassDiscoveryService.adoc | 6 +-
.../guides/_rgsvc-spi_CommandService.adoc | 8 +-
.../_rgsvc-spi_ContentNegotiationService.adoc | 2 +-
.../_rgsvc-spi_EmailNotificationService.adoc | 2 +-
.../_rgsvc-spi_ErrorReportingService.adoc | 2 +-
.../guides/_rgsvc-spi_EventSerializer.adoc | 4 +-
.../guides/_rgsvc-spi_ExceptionRecognizer.adoc | 2 +-
...spi_FixtureScriptsSpecificationProvider.adoc | 2 +-
.../guides/_rgsvc-spi_LocaleProvider.adoc | 2 +-
.../guides/_rgsvc-spi_PublishingService.adoc | 8 +-
.../_rgsvc-spi_RepresentationService.adoc | 2 +-
.../guides/_rgsvc-spi_TranslationService.adoc | 2 +-
.../guides/_rgsvc-spi_TranslationsResolver.adoc | 2 +-
.../_tg_stop-scaffolding-start-coding.adoc | 16 +-
.../_ug_core-concepts_building-blocks.adoc | 6 +-
...concepts_principles_apache-isis-vs_cqrs.adoc | 2 +-
...rinciples_apache-isis-vs_event-sourcing.adoc | 2 +-
.../guides/_ug_faqs_restful-image-property.adoc | 2 +-
.../guides/_ug_how-tos_business-rules.adoc | 6 +-
.../guides/_ug_how-tos_derived-members.adoc | 4 +-
.../guides/_ug_how-tos_domain-services.adoc | 4 +-
.../_ug_how-tos_drop-downs-and-defaults.adoc | 14 +-
...aged-1-to-m-bidirectional-relationships.adoc | 2 +-
...ow-tos_ui-hints_object-titles-and-icons.adoc | 8 +-
.../guides/_ug_how-tos_ui_are-you-sure.adoc | 2 +-
.../guides/_ugbtb_deployment_cmd-line.adoc | 4 +-
.../_ugbtb_more-advanced_decoupling_mixins.adoc | 2 +-
...ore-advanced_decoupling_pushing-changes.adoc | 4 +-
.../guides/_ugbtb_more-advanced_i18n.adoc | 2 +-
...ore-advanced_overriding-jdo-annotations.adoc | 2 +-
.../_ugbtb_more-advanced_persisted-title.adoc | 2 +-
.../_ugbtb_more-advanced_view-models_jaxb.adoc | 2 +-
...-advanced_view-models_programming-model.adoc | 2 +-
...btb_more-advanced_view-models_use-cases.adoc | 2 +-
.../src/main/asciidoc/guides/_ugtst_aaa.adoc | 2 +-
..._ugtst_integ-test-support_bootstrapping.adoc | 4 +-
..._ugtst_integ-test-support_typical-usage.adoc | 2 +-
..._ugtst_unit-test-support_contract-tests.adoc | 2 +-
.../guides/_ugvw_features_blob-attachments.adoc | 2 +-
.../src/main/asciidoc/guides/rg.adoc | 12 +-
277 files changed, 4097 insertions(+), 4097 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/_migration-notes_1.10.0-to-1.11.0.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/_migration-notes_1.10.0-to-1.11.0.adoc b/adocs/documentation/src/main/asciidoc/_migration-notes_1.10.0-to-1.11.0.adoc
index c2ecf93..65128a4 100644
--- a/adocs/documentation/src/main/asciidoc/_migration-notes_1.10.0-to-1.11.0.adoc
+++ b/adocs/documentation/src/main/asciidoc/_migration-notes_1.10.0-to-1.11.0.adoc
@@ -26,6 +26,6 @@ The default implementation is located in the `org.apache.isis.core:isis-core-sch
`org.apache.isis.core.schema.services` package.
If your application is bootstrapped using an `AppManifest` (recommended; ee
-xref:rg.adoc#_rg_classes_AppManifest-bootstrapping[here]) then the `JaxbService` will automatically be discovered and
+xref:rgcms.adoc#_rgcms_classes_AppManifest-bootstrapping[here]) then the `JaxbService` will automatically be discovered and
registered. However, if you are still using the older `isis.properties` configuration file to explicitly register
services then you will need to add in this service.
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/_migration-notes_1.8.0-to-1.9.0_bootstrapping-using-AppManifest.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/_migration-notes_1.8.0-to-1.9.0_bootstrapping-using-AppManifest.adoc b/adocs/documentation/src/main/asciidoc/_migration-notes_1.8.0-to-1.9.0_bootstrapping-using-AppManifest.adoc
index 9b09e2f..16fe795 100644
--- a/adocs/documentation/src/main/asciidoc/_migration-notes_1.8.0-to-1.9.0_bootstrapping-using-AppManifest.adoc
+++ b/adocs/documentation/src/main/asciidoc/_migration-notes_1.8.0-to-1.9.0_bootstrapping-using-AppManifest.adoc
@@ -124,7 +124,7 @@ public class MyAppAppManifest implements AppManifest {
[TIP]
====
-For details of the usages of the other methods in this interface, see the xref:guides/rg.adoc#_rg_classes_AppManifest-bootstrapping[reference guide] documentation.
+For details of the usages of the other methods in this interface, see the xref:guides/rgcms.adoc#_rgcms_classes_AppManifest-bootstrapping[reference guide] documentation.
====
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/_migration-notes_1.8.0-to-1.9.0_fixture-scripts-specification-provider.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/_migration-notes_1.8.0-to-1.9.0_fixture-scripts-specification-provider.adoc b/adocs/documentation/src/main/asciidoc/_migration-notes_1.8.0-to-1.9.0_fixture-scripts-specification-provider.adoc
index 0b94749..21264e5 100644
--- a/adocs/documentation/src/main/asciidoc/_migration-notes_1.8.0-to-1.9.0_fixture-scripts-specification-provider.adoc
+++ b/adocs/documentation/src/main/asciidoc/_migration-notes_1.8.0-to-1.9.0_fixture-scripts-specification-provider.adoc
@@ -6,7 +6,7 @@
-The `FixtureScriptsSpecificationProvider` SPI service is an alternative to subclassing the xref:rg.adoc#_rg_classes_super_manpage-FixtureScripts[`FixtureScripts`] domain service. The logic that would normally be in the subclass moves to the provider service instead, and the framework instantiates a fallback default instance, xref:rgsvc.adoc#_rgsvc-api_FixtureScriptsDefault[`FixtureScriptsDefault`].
+The `FixtureScriptsSpecificationProvider` SPI service is an alternative to subclassing the xref:rgcms.adoc#_rgcms_classes_super_manpage-FixtureScripts[`FixtureScripts`] domain service. The logic that would normally be in the subclass moves to the provider service instead, and the framework instantiates a fallback default instance, xref:rgsvc.adoc#_rgsvc-api_FixtureScriptsDefault[`FixtureScriptsDefault`].
This new design is optional; if you continue to provide your own subclass then everything will continue as before. However the new design is more flexible and involves less code.
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/_migration-notes_1.8.0-to-1.9.0_specify-all-dom-packages.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/_migration-notes_1.8.0-to-1.9.0_specify-all-dom-packages.adoc b/adocs/documentation/src/main/asciidoc/_migration-notes_1.8.0-to-1.9.0_specify-all-dom-packages.adoc
index 21d71c3..7afeecc 100644
--- a/adocs/documentation/src/main/asciidoc/_migration-notes_1.8.0-to-1.9.0_specify-all-dom-packages.adoc
+++ b/adocs/documentation/src/main/asciidoc/_migration-notes_1.8.0-to-1.9.0_specify-all-dom-packages.adoc
@@ -10,7 +10,7 @@ Apache Isis automatically scans for certain classes on the classpath in order to
* searching for classes annotated with xref:rgant.adoc#_rgant-DomainService[`@DomainService`].
-* searching for classes extending xref:rg.adoc#_rg_classes_super_manpage-FixtureScript[`FixtureScript`]
+* searching for classes extending xref:rgcms.adoc#_rgcms_classes_super_manpage-FixtureScript[`FixtureScript`]
* searching for classes annotated with xref:rgant.adoc#_rgant-PersistenceCapable[`@PersistenceCapable`].
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/documentation.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/documentation.adoc b/adocs/documentation/src/main/asciidoc/documentation.adoc
index d119f8c..8d8b46c 100644
--- a/adocs/documentation/src/main/asciidoc/documentation.adoc
+++ b/adocs/documentation/src/main/asciidoc/documentation.adoc
@@ -72,7 +72,7 @@ pass:[<br/>]
* link:./guides/rgant.html[Annotations^]
* link:./guides/rgsvc.html[Domain Services^]
* link:./guides/rgcfg.html[Configuration Properties^]
-* link:./guides/rg.html[Classes, Methods and Schema^]
+* link:./guides/rgcms.html[Classes, Methods and Schema^]
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/guides/_cg_asciidoc-templates.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_cg_asciidoc-templates.adoc b/adocs/documentation/src/main/asciidoc/guides/_cg_asciidoc-templates.adoc
index 9b2cc8c..3366b1a 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_cg_asciidoc-templates.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_cg_asciidoc-templates.adoc
@@ -217,7 +217,7 @@ a hyperlink to the reference guide's catalogue of the Apache Isis configuration
|`adrgcs`
-|pass:[<pre>xref:rg.adoc#_rg_classes_super_manpage-xxx[`xxx`\]</pre>]
+|pass:[<pre>xref:rgcms.adoc#_rgcms_classes_super_manpage-xxx[`xxx`\]</pre>]
a hyperlink to the "man page" for a superclass, where:
@@ -225,14 +225,14 @@ a hyperlink to the "man page" for a superclass, where:
for example:
-pass:[<pre>xref:rg.adoc#_rg_classes_super_manpage-AbstractService[`AbstractService`\]</pre>]
+pass:[<pre>xref:rgcms.adoc#_rgcms_classes_super_manpage-AbstractService[`AbstractService`\]</pre>]
-|xref:rg.adoc#_rg_classes_super_manpage-AbstractService[`AbstractService`]
+|xref:rgcms.adoc#_rgcms_classes_super_manpage-AbstractService[`AbstractService`]
|`adrgcu`
-|pass:[<pre>xref:rg.adoc#_rg_classes_utility_manpage-xxx[`xxx`\]</pre>]
+|pass:[<pre>xref:rgcms.adoc#_rgcms_classes_utility_manpage-xxx[`xxx`\]</pre>]
a hyperlink to the "man page" for a utility class, where:
@@ -240,14 +240,14 @@ a hyperlink to the "man page" for a utility class, where:
for example:
-pass:[<pre>xref:rg.adoc#_rg_classes_utility_manpage-TitleBuffer[`TitleBuffer`\]</pre>]
+pass:[<pre>xref:rgcms.adoc#_rgcms_classes_utility_manpage-TitleBuffer[`TitleBuffer`\]</pre>]
-|xref:rg.adoc#_rg_classes_utility_manpage-TitleBuffer[`TitleBuffer`]
+|xref:rgcms.adoc#_rgcms_classes_utility_manpage-TitleBuffer[`TitleBuffer`]
|`adrgcv`
-|pass:[<pre>xref:rg.adoc#_rg_classes_value-types_manpage-xxx[`xxx`\]</pre>]
+|pass:[<pre>xref:rgcms.adoc#_rgcms_classes_value-types_manpage-xxx[`xxx`\]</pre>]
a hyperlink to the "man page" for an applib value class, where:
@@ -256,14 +256,14 @@ a hyperlink to the "man page" for an applib value class, where:
for example:
-pass:[<pre>xref:rg.adoc#_rg_classes_value-types_manpage-Blob[`Blob`\]</pre>]
+pass:[<pre>xref:rgcms.adoc#_rgcms_classes_value-types_manpage-Blob[`Blob`\]</pre>]
-|xref:rg.adoc#_rg_classes_value-types_manpage-Blob[`Blob`]
+|xref:rgcms.adoc#_rgcms_classes_value-types_manpage-Blob[`Blob`]
|`adrgmp`
-|pass:[<pre>xref:rg.adoc#_rg_methods_prefixes_manpage-xxx[`xxx...()`\]</pre>]
+|pass:[<pre>xref:rgcms.adoc#_rgcms_methods_prefixes_manpage-xxx[`xxx...()`\]</pre>]
a hyperlink to the "man page" for a prefixed method, where:
@@ -271,9 +271,9 @@ a hyperlink to the "man page" for a prefixed method, where:
for example:
-pass:[<pre>xref:rg.adoc#_rg_methods_prefixes_manpage-disable[`disable...()`\]</pre>]
+pass:[<pre>xref:rgcms.adoc#_rgcms_methods_prefixes_manpage-disable[`disable...()`\]</pre>]
-|xref:rg.adoc#_rg_methods_prefixes_manpage-disable[`disable...()`]
+|xref:rgcms.adoc#_rgcms_methods_prefixes_manpage-disable[`disable...()`]
@@ -286,9 +286,9 @@ a hyperlink to the "man page" for a reserved method, where:
for example:
-pass:[<pre>xref:rg.adoc#_rg_methods_reserved_manpage-title[`title()`\]</pre>]
+pass:[<pre>xref:rgcms.adoc#_rgcms_methods_reserved_manpage-title[`title()`\]</pre>]
-|xref:rg.adoc#_rg_methods_reserved_manpage-title[`title()`]
+|xref:rgcms.adoc#_rgcms_methods_reserved_manpage-title[`title()`]
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/guides/_cg_isis-maven-plugin.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_cg_isis-maven-plugin.adoc b/adocs/documentation/src/main/asciidoc/guides/_cg_isis-maven-plugin.adoc
index 7af3cd5..b46dfdd 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_cg_isis-maven-plugin.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_cg_isis-maven-plugin.adoc
@@ -15,18 +15,18 @@ Use to verify at build time that the metamodel of an application is valid. This
+
Uses the xref:rgsvc.adoc#_rgsvc-api_JaxbService[`JaxbService`] to generate XSD schemas from any JAXB-annotated view models/DTOs. +
+
-This is instead of and preferable to using the JAXB link:https://jaxb.java.net/2.2.4/docs/schemagen.html[schemagen] tool, because it uses the framework's support (via xref:rgant.adoc#_rgant-XmlJavaValueType[`@XmlJavaValueType`]) to translate any references to domain objects into ``OidDto``s (as defined by the Apache Isis xref:rg.adoc#_rg_schema-common[common schema]).
+This is instead of and preferable to using the JAXB link:https://jaxb.java.net/2.2.4/docs/schemagen.html[schemagen] tool, because it uses the framework's support (via xref:rgant.adoc#_rgant-XmlJavaValueType[`@XmlJavaValueType`]) to translate any references to domain objects into ``OidDto``s (as defined by the Apache Isis xref:rgcms.adoc#_rgcms_schema-common[common schema]).
The `validate` goal is by default bound to the `test` phase of your application's `dom` sub-module, whereas the `xsd` goal defaults to the `generate-resources` phase of a completely separate `canonical` submodule. An example can be found in the (non-ASF) http://github.com/isisaddons/isis-app-todoapp[Isis addons' todoapp] example app.
-Both goals require an xref:rg.adoc#_rg_classes_AppManifest-bootstrapping[`AppManifest`] to point the plugin at, so that
+Both goals require an xref:rgcms.adoc#_rgcms_classes_AppManifest-bootstrapping[`AppManifest`] to point the plugin at, so that
it knows how to bootstrap an Isis runtime. This is discussed below, followed by sections on configuring the two goals.
== `AppManifest`
-As noted in the introduction, both goals require an xref:rg.adoc#_rg_classes_AppManifest-bootstrapping[`AppManifest`]
+As noted in the introduction, both goals require an xref:rgcms.adoc#_rgcms_classes_AppManifest-bootstrapping[`AppManifest`]
to point the plugin at, so that it knows how to bootstrap an Isis runtime.
This can be extremely minimal. For example, the xref:ug.adoc#_ug_getting-started_simpleapp-archetype[SimpleApp]'s
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/guides/_cg_isis-maven-plugin_xsd.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_cg_isis-maven-plugin_xsd.adoc b/adocs/documentation/src/main/asciidoc/guides/_cg_isis-maven-plugin_xsd.adoc
index 6b87aca..179e4f4 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_cg_isis-maven-plugin_xsd.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_cg_isis-maven-plugin_xsd.adoc
@@ -12,7 +12,7 @@ generate XSD schemas from any JAXB-annotated xref:ugbtb.adoc#_ugbtb_more-advance
This is instead of and preferable to using the JAXB link:https://jaxb.java.net/2.2.4/docs/schemagen.html[schemagen]
tool, because it uses the framework's support (via
xref:rgant.adoc#_rgant-XmlJavaValueType[`@XmlJavaValueType`]) to translate any references to domain
-objects into ``OidDto``s (as defined by the Apache Isis xref:rg.adoc#_rg_schema-common[common schema]).
+objects into ``OidDto``s (as defined by the Apache Isis xref:rgcms.adoc#_rgcms_schema-common[common schema]).
The `xsd` goal defines the following properties:
@@ -26,7 +26,7 @@ Defaults to `generated-resources/isis-xsd`
* `separate` - (optional) whether to create separate directories for each JAXB-class. +
+
-Defaults to `false`. Most DTO classes will reference one another or the xref:rg.adoc#_rg_schema-common[common schema]. Normally it's fine to merge all these XSDs together. This property, if set, results in each a separate directory for each generation of its XSD or XSDs.
+Defaults to `false`. Most DTO classes will reference one another or the xref:rgcms.adoc#_rgcms_schema-common[common schema]. Normally it's fine to merge all these XSDs together. This property, if set, results in each a separate directory for each generation of its XSD or XSDs.
As a convenience to any (Java) consumers, the XSDs generated from the view models can then in turn be generated
into DTOs. The original view models and these DTOs are similar but not identical: while the view models can only be used
@@ -276,14 +276,14 @@ The `xjc` profile is defined as:
<1> enabled _unless_ `skip.xjc` property specified
<2> specifies the directory that the XSD schemas were generated to by the `isis-maven-plugin`
<3> specify each of the XSDs to be processed
-<4> catalog file indicates the location of the referenced link:_rg_schema-common[common schema] XSDs.
+<4> catalog file indicates the location of the referenced link:_rgcms_schema-common[common schema] XSDs.
<5> the `build-helper-maven-plugin` adds the Java source generated by the `xjc` plugin so that it can be compiled and
packaged as any other code
<6> the location that the `xjc` plugin generates its source code.
The referenced `catalog.xml` file instructs the `xjc` plugin how to resolve referenced schema locations. Only a
-reference for the Apache Isis link:_rg_schema-common[common schema] is likely to be needed:
+reference for the Apache Isis link:_rgcms_schema-common[common schema] is likely to be needed:
[source,xml]
----
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/guides/_rg_classes.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rg_classes.adoc b/adocs/documentation/src/main/asciidoc/guides/_rg_classes.adoc
deleted file mode 100644
index 0479db0..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_rg_classes.adoc
+++ /dev/null
@@ -1,23 +0,0 @@
-[[_rg_classes]]
-= Classes and Interfaces
-: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 chapter describes the usage of various classes and interfaces that are not otherwise associated with xref:rgsvc.adoc#_rgsvc-api[domain] xref:rgsvc.adoc#_rgsvc-spi[services], xref:ug.adoc#_ug_object-layout[object layout] or xref:rgcfg.adoc#_rgcfg[configuration].
-
-
-include::_rg_classes_AppManifest-bootstrapping.adoc[leveloffset=+1]
-include::_rg_classes_super.adoc[leveloffset=+1]
-include::_rg_classes_domainevent.adoc[leveloffset=+1]
-include::_rg_classes_uievent.adoc[leveloffset=+1]
-include::_rg_classes_lifecycleevent.adoc[leveloffset=+1]
-include::_rg_classes_value-types.adoc[leveloffset=+1]
-include::_rg_classes_utility.adoc[leveloffset=+1]
-include::_rg_classes_spec.adoc[leveloffset=+1]
-include::_rg_classes_i18n.adoc[leveloffset=+1]
-include::_rg_classes_contributee.adoc[leveloffset=+1]
-include::_rg_classes_roles.adoc[leveloffset=+1]
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/guides/_rg_classes_AppManifest-bootstrapping.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_AppManifest-bootstrapping.adoc b/adocs/documentation/src/main/asciidoc/guides/_rg_classes_AppManifest-bootstrapping.adoc
deleted file mode 100644
index cbb1dae..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_AppManifest-bootstrapping.adoc
+++ /dev/null
@@ -1,282 +0,0 @@
-[[_rg_classes_AppManifest-bootstrapping]]
-= `AppManifest` (bootstrapping)
-: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 describes how to implement the `AppManifest` interface to bootstrap both an Apache Isis web application, and also its integration tests.
-
-
-
-== API
-
-
-The `AppManifest` interface allows the constituent parts of an application to be defined programmatically, most specifically the packages that contain domain services and/or persistent entities. Its API is defined as:
-
-[source,java]
-----
-public interface AppManifest {
- public List<Class<?>> getModules(); // <1>
- public List<Class<?>> getAdditionalServices(); // <2>
- public String getAuthenticationMechanism(); // <3>
- public String getAuthorizationMechanism(); // <4>
- public List<Class<? extends FixtureScript>> getFixtures(); // <5>
- public Map<String,String> getConfigurationProperties(); // <6>
-}
-----
-<1> Must return a non-null list of classes, each of which representing the root of one of the modules containing services and possibly entities, which together makes up the running application.
-<2> If non-`null`, overrides the value of `isis.services` configuration property to specify a list of additional classes to be instantiated as domain services (over and above the domain services defined via `getModules()` method.
-<3> If non-`null`, overrides the value of `isis.authentication` configuration property to specify the authentication mechanism.
-<4> If non-`null`, overrides the value of `isis.authorization` configuration property to specify the authorization mechanism.
-<5> If non-`null`, overrides the value of `isis.fixtures` configuration property to specify a fixture script to be installed.
-<6> Overrides for any other configuration properties.
-
-The following sections describe each of these methods in a little more detail.
-
-
-
-
-=== `getModules()`
-
-The most significant method (the only one which must return a non-`null` value) is the `getModules()` method. Each module is identified by a class; the framework simply uses that class' package as the root to search for domain services (annotated with xref:rgant.adoc#_rgant-DomainService[`@DomainService`]) and entities (annotated with xref:rgant.adoc#_rgant-PersistenceCapable[`@PersistenceCapable`]). Generally there is one such module class per Maven module.
-
-A module class for a domain module might for example be defined as:
-
-[source,java]
-----
-package com.mycompany.myapp.dom;
-public final class MyAppDomainModule {
- private MyAppDomainModule() {}
-}
-----
-
-This tells the framework that the package and subpackages under `com.mycompany.myapp.dom` should be searched for domain services and entities.
-
-As is perhaps apparent, the `getModules()` method replaces and overrides both the `isis.services.ServicesInstallerFromAnnotation.packagePrefix` key (usually found in the `isis.properties` file) and also the`isis.persistor.datanucleus.RegisterEntities.packagePrefix` key (usually found in the `persistor_datanucleus.properties` file). The value of the `isis.services-installer` configuration property is also ignored.
-
-For example, the (non-ASF) http://github.com/isisaddons/isis-app-todoapp[Isis addons' todoapp] defines the following:
-
-[source,java]
-----
-@Override
-public List<Class<?>> getModules() {
- return Arrays.asList(
- ToDoAppDomainModule.class,
- ToDoAppFixtureModule.class,
- ToDoAppAppModule.class,
- org.isisaddons.module.audit.AuditModule.class,
- org.isisaddons.module.command.CommandModule.class,
- org.isisaddons.module.devutils.DevUtilsModule.class,
- org.isisaddons.module.docx.DocxModule.class,
- org.isisaddons.module.publishing.PublishingModule.class,
- org.isisaddons.module.sessionlogger.SessionLoggerModule.class,
- org.isisaddons.module.settings.SettingsModule.class,
- org.isisaddons.wicket.gmap3.cpt.service.Gmap3ServiceModule.class
- );
-}
-----
-
-As can be seen, the various (non-ASF) link:http://isisaddons.org[Isis Addons] modules also each provide a module class that can be easily referenced.
-
-
-=== `getAdditionalServices()`
-
-We normally we recommend that services are defined exclusively through `getModules()`, and that this method should therefore return an empty list. However, there are certain use cases where the a service must be explicitly specified either because the service required does not (for whatever reason) have a xref:rgant.adoc#_rgant-DomainService[`@DomainService`] annotation.
-
-For example, the (non-ASF) http://github.com/isisaddons/isis-module-security[Isis addons' security] module (v1.9.0) allows the policy to evaluate conflicting permissions to be specified by explicitly registering either the `PermissionsEvaluationServiceAllowBeatsVeto` domain service or the `PermissionsEvaluationServiceVetoBeatsAllow` domain service:
-
-[source,java]
-----
-@Override
-public List<Class<?>> getAdditionalServices() {
- return Arrays.asList(
- org.isisaddons.module.security.dom.permission.PermissionsEvaluationServiceVetoBeatsAllow.class
- );
-}
-----
-
-If this method returns a non-`null` value, then it overrides the value of `isis.services` configuration property.
-
-
-
-
-=== `getAuthenticationMechanism()`
-
-If non-`null`, this method specifies the authentication mechanism to use. The valid values are currently `"shiro"` or `"bypass"`. If null is returned then the value of the `isis.authentication` configuration property (in `isis.properties` file) is used instead.
-
-See the xref:ugsec.adoc#[security guide] for further details on configuring shiro or bypass security.
-
-[NOTE]
-====
-This property is ignored for integration tests (which always uses the `"bypass"` mechanism).
-====
-
-
-
-=== `getAuthorizationMechanism()`
-
-If non-`null`, this method specifies the authorization mechanism to use. The valid values are currently `"shiro"` or `"bypass"`. If null is returned then the value of the `isis.authorization` configuration property (in `isis.properties` file) is used instead.
-
-See the xref:ugsec.adoc#[security guide] for further details on configuring shiro or bypass security.
-
-[NOTE]
-====
-This property is ignored for integration tests (which always uses the `"bypass"` mechanism).
-====
-
-
-
-
-=== `getFixtures()`
-
-If non-`null`, this method specifies the fixture script(s) to be run on startup. This is particularly useful when developing or demoing while using an in-memory database.
-
-For example:
-
-[source,java]
-----
-@Override
-public List<Class<? extends FixtureScript>> getFixtures() {
- return Lists.newArrayList(todoapp.fixture.demo.DemoFixture.class);
-}
-----
-
-
-
-Note that in order for fixtures to be installed it is also necessary to set the `isis.persistor.datanucleus.install-fixtures` key to `true`. This can most easily be done using the `getConfigurationProperties()` method, discussed below.
-
-
-
-=== `getConfigurationProperties()`
-
-This method allow arbitrary other configuration properties to be overridden. One common use case is in conjunction with the `getFixtures()` method, discussed above:
-
-[source,java]
-----
-@Override
-public Map<String, String> getConfigurationProperties() {
- Map<String, String> props = Maps.newHashMap();
- props.put("isis.persistor.datanucleus.install-fixtures", "true");
- return props;
-}
-----
-
-
-
-
-
-
-
-== Bootstrapping
-
-One of the primary goals of the `AppManifest` is to unify the bootstrapping of both integration tests and the webapp. This requires that the integration tests and webapp can both reference the implementation.
-
-We strongly recommend using a `myapp-app` Maven module to hold the implementation of the `AppManifest`. This Maven module can then also hold dependencies which are common to both integration tests and the webapp, specifically the `org.apache.isis.core:isis-core-runtime` and the `org.apache.isis.core:isis-core-wrapper` modules.
-
-We also strongly recommend that any application-layer domain services and view models (code that references persistent domain entities but that is not referenced back) is moved to this `myapp-app` module. This will allow the architectural layering of the overall application to be enforced by Maven.
-
-What then remains is to update the bootstrapping code itself.
-
-
-=== Integration Tests
-
-Bootstrapping integration tests is still performed using the `IsisSystemForTest.Builder`, but very often the bootstrapping code can be substantially simplified (compared to not using an `AppManifest`, that is).
-
-For example, this is the bootstrapping code for the xref:ug.adoc#_ug_getting-started_simpleapp-archetype[SimpleApp archetype] looks something like:
-
-[source,java]
-----
-public class DomainAppSystemInitializer {
- public static void initIsft() {
- IsisSystemForTest isft = IsisSystemForTest.getElseNull();
- if(isft == null) {
- isft = new IsisSystemForTest.Builder()
- .withLoggingAt(org.apache.log4j.Level.INFO)
- .with(new MyAppAppManifest())
- .with(new IsisConfigurationForJdoIntegTests())
- .build()
- .setUpSystem();
- IsisSystemForTest.set(isft);
- }
- }
-}
-----
-
-
-
-
-=== Webapps
-
-To bootstrap an Apache Isis webapp (using the xref:ugvw.adoc#[Wicket viewer]), there are two choices:
-
-* either specify the `AppManifest` by overriding the `IsisWicketApplication#newWicketModule()`, eg: +
-+
-[source,java]
-----
-@Override
-protected Module newIsisWicketModule() {
- final Module isisDefaults = super.newIsisWicketModule();
- ...
- final Module overrides = new AbstractModule() {
- @Override
- protected void configure() {
- ...
- bind(AppManifest.class).toInstance(new MyAppAppManifest());
- }
- };
- return Modules.override(isisDefaults).with(overrides);
-}
-----
-
-* alternatively update `isis.properties`, using the `isis.appManifest` key to specify the `AppManifest` implementation, eg: +
-+
-[source,ini]
-----
-isis.appManifest=domainapp.app.MyAppAppManifest
-----
-
-The first (programmatic) approach takes precedence over the second approach (configuration properties).
-
-[TIP]
-====
-If you use the `org.apache.isis.WebServer` class to launch your application from the xref:ugbtb.adoc#_ugbtb_deployment_cmd-line[command line], then note that you can specify the `AppManifest` using the `-m` (or `--manifest`) flag:
-
-[source,ini]
-----
-java org.apache.isis.WebServer -m com.mycompany.myapp.MyAppAppManifestWithFixtures
-----
-
-====
-
-
-
-
-
-
-
-
-
-
-== Subsidiary Goals
-
-There are a number of subsidiary goals of the `AppManifest` class (though as of v1.9.0 these have not yet implemented):
-
-* Allow different integration tests to run with different manifests.
-
-** Normally the running application is shared (on a thread-local) between integration tests. What the framework could do is to be intelligent enough to keep track of the manifest in use for each integration test and tear down the shared state if the "next" test uses a different manifest
-
-* Speed up bootstrapping by only scanning for classes annotated by `@DomainService` and `@PersistenceCapable` once.
-
-* Provide a programmatic way to contribute elements of `web.xml`.
-
-* Provide a programmatic way to configure Shiro security.
-
-* Anticipate the module changes forthcoming in Java 9.
-
-** Eventually we see that the `AppManifest` class acting as an "aggregator", with the list of modules will become Java 9 modules each advertising the types that they export.
-** It might even be possible for ``AppManifest``s to be switched on and off dynamically (eg if Java9 is compatible with OSGi, being one of the design goals).
-
-
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/guides/_rg_classes_contributee.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_contributee.adoc b/adocs/documentation/src/main/asciidoc/guides/_rg_classes_contributee.adoc
deleted file mode 100644
index 78d9c5a..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_contributee.adoc
+++ /dev/null
@@ -1,13 +0,0 @@
-[[_rg_classes_contributee]]
-= Contributee
-: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 interfaces listed in this chapter act as contributees; they allow domain services to contribute actions/properties/collections to any domain objects that implement these interfaces.
-
-
-include::_rg_classes_contributee_manpage-HasTransactionId.adoc[leveloffset=+1]
-include::_rg_classes_contributee_manpage-HasUserName.adoc[leveloffset=+1]
-
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/guides/_rg_classes_contributee_manpage-HasTransactionId.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_contributee_manpage-HasTransactionId.adoc b/adocs/documentation/src/main/asciidoc/guides/_rg_classes_contributee_manpage-HasTransactionId.adoc
deleted file mode 100644
index c645745..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_contributee_manpage-HasTransactionId.adoc
+++ /dev/null
@@ -1,31 +0,0 @@
-[[_rg_classes_mixins_manpage-HasTransactionId]]
-= `HasTransactionId`
-: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 `HasTransactionId` interface is a mix-in for any domain objects that reference a transaction id, such as
-auditing entries or commands.
-
-The interface is defined is:
-
-[source,java]
-----
-public interface HasTransactionId {
-
- public UUID getTransactionId(); // <1>
- public void setTransactionId(final UUID transactionId);
-}
-----
-<1> unique identifier (a GUID) of the transaction in which this interaction occurred.
-
-
-
-Modules that either have domain entity that implement and/or services that contribute this interface are:
-
-* (non-ASF) http://github.com/isisaddons/isis-module-audit[Isis addons' audit] module (`AuditEntry` entity, `AuditingServiceContributions` service)
-* (non-ASF) http://github.com/isisaddons/isis-module-command[Isis addons' command] module (`CommandJdo` entity, `CommandServiceJdoContributions` service)
-* (non-ASF) http://github.com/isisaddons/isis-module-publishing[Isis addons' publishing] module (`PublishedEvent` entity, `PublishingServiceContributions`)
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/guides/_rg_classes_contributee_manpage-HasUserName.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_contributee_manpage-HasUserName.adoc b/adocs/documentation/src/main/asciidoc/guides/_rg_classes_contributee_manpage-HasUserName.adoc
deleted file mode 100644
index 1618b5c..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_contributee_manpage-HasUserName.adoc
+++ /dev/null
@@ -1,27 +0,0 @@
-[[_rg_classes_mixins_manpage-HasUserName]]
-= `HasUsername`
-: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 `HasUsername` interface is a mix-in for domain objects to be associated with a username. Other services and modules can then contribute actions/collections to render such additional information relating to the activities of the user.
-
-The interface is defined is:
-
-[source,java]
-----
-public interface HasUsername {
- public String getUsername();
-}
-----
-
-Modules that either have domain entity that implement and/or services that contribute this interface are:
-
-* (non-ASF) http://github.com/isisaddons/isis-module-security[Isis addons' security] module ( `ApplicationUser` entity, `HasUsernameContributions` service)
-* (non-ASF) http://github.com/isisaddons/isis-module-audit[Isis addons' audit] module (`AuditEntry` entity,
-* (non-ASF) http://github.com/isisaddons/isis-module-command[Isis addons' command] module's `CommandJdo` entity, `HasUsernameContributions` service)
-* (non-ASF) http://github.com/isisaddons/isis-module-publishing[Isis addons' publishing] module (`PublishedEvent` entity)
-* (non-ASF) http://github.com/isisaddons/isis-module-sessionlogger[Isis addons' sessionlogger] module (`SessionLogEntry` entity, `HasUsernameContributions` service)
-* (non-ASF) http://github.com/isisaddons/isis-module-settings[Isis addons' settings] module (`UserSettingJdo` entity)
-
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/guides/_rg_classes_domainevent.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_domainevent.adoc b/adocs/documentation/src/main/asciidoc/guides/_rg_classes_domainevent.adoc
deleted file mode 100644
index 5efc7ae..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_domainevent.adoc
+++ /dev/null
@@ -1,76 +0,0 @@
-[[_rg_classes_domainevent]]
-= Domain Event Classes
-: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 catalogues the various domain event classes defined by Apache Isis.
-
-These events are broadcast on the xref:rgsvc.adoc#_rgsvc-api_EventBusService[`EventBusService`]. The domain
-events are broadcast as a result of being specified in the xref:rgant.adoc#_rgant-Action_domainEvent[`@Action#domainEvent()`], xref:rgant.adoc#_rgant-Property_domainEvent[`@Property#domainEvent()`] or xref:rgant.adoc#_rgant-Collection_domainEvent[`@Collection#domainEvent()`] attributes.
-
-They are listed in the table below.
-
-.Domain Event Classes
-[cols="2,4a,1,1", options="header"]
-|===
-
-|API
-|Maven Module +
-Impl'n (g: a:)
-|Implementation
-|Notes
-
-
-|xref:rg.adoc#_rg_classes_domainevent_manpage-AbstractDomainEvent[`o.a.i.applib.` +
-`AbstractDomainEvent`]
-|``o.a.i.core`` +
-``services.eventbus`` +
-``isis-core-applib``
-|(abstract class)
-|Superclass of the other domain events, listed below in this table.
-
-
-|xref:rg.adoc#_rg_classes_domainevent_manpage-ActionDomainEvent[`o.a.i.applib.` +
-`ActionDomainEvent`]
-|``o.a.i.core`` +
-``services.eventbus`` +
-``isis-core-applib``
-|(abstract class). +
-`ActionDomainEvent.Default` is the concrete implementation used if no `@Action#domainEvent` attribute is specified
-|Broadcast whenever there is an interaction (hide/disable/validate/pre-execute/post-execute) with an object's action.
-
-
-|xref:rg.adoc#_rg_classes_domainevent_manpage-CollectionDomainEvent[`o.a.i.applib.` +
-`CollectionDomainEvent`]
-|``o.a.i.core`` +
-``services.eventbus`` +
-``isis-core-applib``
-|(abstract class). +
-`CollectionDomainEvent.Default` is the concrete implementation used if no `@Collection#domainEvent` attribute
-is specified.
-|Broadcast whenever there is an interaction (hide/disable/validate/access) with an object's collection.
-
-
-|xref:rg.adoc#_rg_classes_domainevent_manpage-PropertyDomainEvent[`o.a.i.applib.` +
-`PropertyDomainEvent`]
-|``o.a.i.core`` +
-``services.eventbus`` +
-``isis-core-applib``
-|(abstract class). +
-`PropertyDomainEvent.Default` is the concrete implementation used if no `@Propert#domainEvent` attribute is specified
-|Broadcast whenever there is an interaction (hide/disable/validate/access) with an object's property.
-
-
-
-|===
-
-
-
-
-include::_rg_classes_domainevent_manpage-AbstractDomainEvent.adoc[leveloffset=+1]
-include::_rg_classes_domainevent_manpage-ActionDomainEvent.adoc[leveloffset=+1]
-include::_rg_classes_domainevent_manpage-CollectionDomainEvent.adoc[leveloffset=+1]
-include::_rg_classes_domainevent_manpage-PropertyDomainEvent.adoc[leveloffset=+1]
-
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/guides/_rg_classes_domainevent_manpage-AbstractDomainEvent.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_domainevent_manpage-AbstractDomainEvent.adoc b/adocs/documentation/src/main/asciidoc/guides/_rg_classes_domainevent_manpage-AbstractDomainEvent.adoc
deleted file mode 100644
index ac5276f..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_domainevent_manpage-AbstractDomainEvent.adoc
+++ /dev/null
@@ -1,20 +0,0 @@
-[[_rg_classes_domainevent_manpage-AbstractDomainEvent]]
-= `AbstractDomainEvent`
-: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 class is the superclass for all domain events that are raised by the framework when interacting with actions, properties or collections.
-
-Its immediate subclasses are:
-
-* xref:rg.adoc#_rg_classes_domainevent_manpage-ActionDomainEvent[`ActionDomainEvent`]
-
-* xref:rg.adoc#_rg_classes_domainevent_manpage-PropertyDomainEvent[`PropertyDomainEvent`]
-
-* xref:rg.adoc#_rg_classes_domainevent_manpage-CollectionDomainEvent[`CollectionDomainEvent`]
-
-This class defines the `Phase` enum that is common to all domain events (hide/disable/validate/pre-execute/post-execute), and provides methods such as `veto(...)` by which subscribers can influence the interaction (eg hide a collection, disable a property, validate action arguments).
-
-It class also provides `get(...)` and `put(...)` methods that allow adhoc sharing of user data between different phases. One event instance is used for both the hide and disable phases, and a different event instance is shared between validate/pre-execute/post-execute.
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/guides/_rg_classes_domainevent_manpage-ActionDomainEvent.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_domainevent_manpage-ActionDomainEvent.adoc b/adocs/documentation/src/main/asciidoc/guides/_rg_classes_domainevent_manpage-ActionDomainEvent.adoc
deleted file mode 100644
index 289e1b6..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_domainevent_manpage-ActionDomainEvent.adoc
+++ /dev/null
@@ -1,20 +0,0 @@
-[[_rg_classes_domainevent_manpage-ActionDomainEvent]]
-= `ActionDomainEvent`
-: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/
-
-
-Subclass of xref:rg.adoc#_rg_classes_domainevent_manpage-AbstractDomainEvent[`AbstractDomainEvent`] for actions.
-
-The class has a number of responsibilities (in addition to those it inherits):
-
-* capture the target object being interacted with
-
-* capture the arguments for each of the action's parameters
-
-* provide selected metadata about the action parameters from the metamodel (names, types)
-
-* link back to the xref:rgsvc.adoc#_rgsvc-api_CommandContext[`CommandContext`] service's `Command` object
-
-The class itself is instantiated automatically by the framework whenever interacting with a rendered object's action.
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/guides/_rg_classes_domainevent_manpage-CollectionDomainEvent.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_domainevent_manpage-CollectionDomainEvent.adoc b/adocs/documentation/src/main/asciidoc/guides/_rg_classes_domainevent_manpage-CollectionDomainEvent.adoc
deleted file mode 100644
index 030ba87..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_domainevent_manpage-CollectionDomainEvent.adoc
+++ /dev/null
@@ -1,21 +0,0 @@
-[[_rg_classes_domainevent_manpage-CollectionDomainEvent]]
-= `CollectionDomainEvent`
-: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/
-
-
-Subclass of xref:rg.adoc#_rg_classes_domainevent_manpage-AbstractDomainEvent[`AbstractDomainEvent`] for collections.
-
-The class has a couple of responsibilities (in addition to those it inherits):
-
-* capture the target object being interacted with
-
-* indicate whether the interaction is to add or remove an object from the collection (or simply to indicate that the collection is being accessed/read)
-
-* capture the object reference being added or removed
-
-
-The class itself is instantiated automatically by the framework whenever interacting with a rendered object's collection.
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/guides/_rg_classes_domainevent_manpage-PropertyDomainEvent.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_domainevent_manpage-PropertyDomainEvent.adoc b/adocs/documentation/src/main/asciidoc/guides/_rg_classes_domainevent_manpage-PropertyDomainEvent.adoc
deleted file mode 100644
index a843152..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_domainevent_manpage-PropertyDomainEvent.adoc
+++ /dev/null
@@ -1,17 +0,0 @@
-[[_rg_classes_domainevent_manpage-PropertyDomainEvent]]
-= `PropertyDomainEvent`
-: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/
-
-
-Subclass of xref:rg.adoc#_rg_classes_domainevent_manpage-AbstractDomainEvent[`AbstractDomainEvent`] for properties.
-
-The class has a couple of responsibilities (in addition to those it inherits):
-
-* capture the target object being interacted with
-
-* capture the old and new values of the property
-
-
-The class itself is instantiated automatically by the framework whenever interacting with a rendered object's property.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/guides/_rg_classes_i18n.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_i18n.adoc b/adocs/documentation/src/main/asciidoc/guides/_rg_classes_i18n.adoc
deleted file mode 100644
index 7e7c806..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_i18n.adoc
+++ /dev/null
@@ -1,11 +0,0 @@
-[[_rg_classes_i18n]]
-= i18n support
-: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 `org.apache.isis.applib.services.i18n` package contains a single class to support i18n.
-
-
-include::_rg_classes_i18n_manpage-TranslatableString.adoc[leveloffset=+1]
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/guides/_rg_classes_i18n_manpage-TranslatableString.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_i18n_manpage-TranslatableString.adoc b/adocs/documentation/src/main/asciidoc/guides/_rg_classes_i18n_manpage-TranslatableString.adoc
deleted file mode 100644
index b630b5a..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_i18n_manpage-TranslatableString.adoc
+++ /dev/null
@@ -1,13 +0,0 @@
-[[_rg_classes_i18n_manpage-TranslatableString]]
-= `TranslatableString`
-: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 - see xref:ugbtb.adoc#_ugbtb_more-advanced_i18n[user guide, i18n].
-
-The `TranslatableString` utility class ...
-
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent.adoc b/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent.adoc
deleted file mode 100644
index beb6341..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent.adoc
+++ /dev/null
@@ -1,130 +0,0 @@
-[[_rg_classes_lifecycleevent]]
-= Lifecycle Events
-: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 catalogues the various lifecycle event classes defined by Apache Isis. These events
-are fired automatically when a domain object is loaded, created, updated and so forth.
-
-The lifecycle event classes are listed in the table below:
-
-
-.Lifecycle Event Classes
-[cols="2,4a,1,1", options="header"]
-|===
-
-|API
-|Maven Module +
-Impl'n (g: a:)
-|Implementation
-|Notes
-
-
-|xref:rg.adoc#_rg_classes_lifecycleevent_manpage-AbstractLifecycleEvent[`o.a.i.applib.` +
-`AbstractLifecycleEvent`]
-|``o.a.i.core`` +
-``services.eventbus`` +
-``isis-core-applib``
-|(abstract class)
-|Superclass of the other lifecycle events, listed below in this table.
-
-
-|xref:rg.adoc#_rg_classes_lifecycleevent_manpage-ObjectCreatedDomainEvent[`o.a.i.applib.` +
-`ObjectCreatedEvent`]
-|``o.a.i.core`` +
-``services.eventbus`` +
-``isis-core-applib``
-|(abstract class). +
-`ObjectCreatedEvent.Default` is the concrete implementation that is used.
-|Broadcast when an object is first instantiated
-using the xref:rgsvc.adoc#_rgsvc-api_DomainObjectContainer_object-creation-api[`DomainObjectContainer`]'s
-`#newTransientInstance(...)` method.
-
-
-|xref:rg.adoc#_rg_classes_lifecycleevent_manpage-ObjectLoadedDomainEvent[`o.a.i.applib.` +
-`ObjectLoadedEvent`]
-|``o.a.i.core`` +
-``services.eventbus`` +
-``isis-core-applib``
-|(abstract class). +
-`ObjectLoadedEvent.Default` is the concrete implementation that is used.
-|Broadcast when an object is retrieved from the database.
-
-
-|xref:rg.adoc#_rg_classes_lifecycleevent_manpage-ObjectPersistedDomainEvent[`o.a.i.applib.` +
-`ObjectPersistedEvent`]
-|``o.a.i.core`` +
-``services.eventbus`` +
-``isis-core-applib``
-|(abstract class). +
-`ObjectPersistedEvent.Default` is the concrete implementation that is used.
-|Broadcast when an object is first saved (inserted) into the database using the
-xref:rgsvc.adoc#_rgsvc-api_DomainObjectContainer_object-persistence-api[`DomainObjectContainer`]'s
-`#persist(...)` method.
-
-
-|xref:rg.adoc#_rg_classes_lifecycleevent_manpage-ObjectPersistingDomainEvent[`o.a.i.applib.` +
-`ObjectPersistingEvent`]
-|``o.a.i.core`` +
-``services.eventbus`` +
-``isis-core-applib``
-|(abstract class). +
-`ObjectPersistingEvent.Default` is the concrete implementation that is used.
-|Broadcast when an object is about to be saved (inserted) into the database using the
-xref:rgsvc.adoc#_rgsvc-api_DomainObjectContainer_object-persistence-api[`DomainObjectContainer`]'s
-`#persist(...)` method.
-
-
-|xref:rg.adoc#_rg_classes_lifecycleevent_manpage-ObjectRemovingDomainEvent[`o.a.i.applib.` +
-`ObjectRemovingEvent`]
-|``o.a.i.core`` +
-``services.eventbus`` +
-``isis-core-applib``
-|(abstract class). +
-`ObjectRemovingEvent.Default` is the concrete implementation that is used.
-|Broadcast when an object is about to be deleted from the database using the
-xref:rgsvc.adoc#_rgsvc-api_DomainObjectContainer_object-persistence-api[`DomainObjectContainer`]'s
-`#remove(...)` method.
-
-
-|xref:rg.adoc#_rg_classes_lifecycleevent_manpage-ObjectUpdatedDomainEvent[`o.a.i.applib.` +
-`ObjectUpdatedEvent`]
-|``o.a.i.core`` +
-``services.eventbus`` +
-``isis-core-applib``
-|(abstract class). +
-`ObjectUpdatedEvent.Default` is the concrete implementation that is used.
-|Broadcast when an object has just been updated in the database. This is done either explicitly when the current
-transaction is flushed using the
-xref:rgsvc.adoc#_rgsvc-api_DomainObjectContainer_object-persistence-api[`DomainObjectContainer`]'s
-`#flush(...)` method, else is done implicitly when the transaction commits at the end of the user request.
-
-
-|xref:rg.adoc#_rg_classes_lifecycleevent_manpage-ObjectUpdatingDomainEvent[`o.a.i.applib.` +
-`ObjectUpdatingEvent`]
-|``o.a.i.core`` +
-``services.eventbus`` +
-``isis-core-applib``
-|(abstract class). +
-`ObjectUpdatingEvent.Default` is the concrete implementation that is used.
-|Broadcast when an object is about to be updated in the database. This is done either explicitly when the current
-transaction is flushed using the
-xref:rgsvc.adoc#_rgsvc-api_DomainObjectContainer_object-persistence-api[`DomainObjectContainer`]'s
-`#flush(...)` method, else is done implicitly when the transaction commits at the end of the user request.
-
-
-|===
-
-
-
-include::_rg_classes_lifecycleevent_manpage-AbstractLifecycleEvent.adoc[leveloffset=+1]
-include::_rg_classes_lifecycleevent_manpage-ObjectCreatedEvent.adoc[leveloffset=+1]
-include::_rg_classes_lifecycleevent_manpage-ObjectLoadedEvent.adoc[leveloffset=+1]
-include::_rg_classes_lifecycleevent_manpage-ObjectPersistedEvent.adoc[leveloffset=+1]
-include::_rg_classes_lifecycleevent_manpage-ObjectPersistingEvent.adoc[leveloffset=+1]
-include::_rg_classes_lifecycleevent_manpage-ObjectRemovingEvent.adoc[leveloffset=+1]
-include::_rg_classes_lifecycleevent_manpage-ObjectUpdatedEvent.adoc[leveloffset=+1]
-include::_rg_classes_lifecycleevent_manpage-ObjectUpdatingEvent.adoc[leveloffset=+1]
-
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent_manpage-AbstractLifecycleEvent.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent_manpage-AbstractLifecycleEvent.adoc b/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent_manpage-AbstractLifecycleEvent.adoc
deleted file mode 100644
index e7baf30..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent_manpage-AbstractLifecycleEvent.adoc
+++ /dev/null
@@ -1,27 +0,0 @@
-[[_rg_classes_lifecycleevent_manpage-AbstractLifecycleEvent]]
-= `AbstractLifecycleEvent`
-: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 class is the superclass for all lifecycle events that are raised by the framework when loading, saving, updating
-or deleting objects from the database.
-
-Its immediate subclasses are:
-
-* xref:rg.adoc#_rg_classes_lifecycleevent_manpage-ObjectCreatedEvent[`ObjectCreatedEvent`]
-
-* xref:rg.adoc#_rg_classes_lifecycleevent_manpage-ObjectLoadedEvent[`ObjectLoadedEvent`]
-
-* xref:rg.adoc#_rg_classes_lifecycleevent_manpage-ObjectPersistedEvent[`ObjectPersistedEvent`]
-
-* xref:rg.adoc#_rg_classes_lifecycleevent_manpage-ObjectPersistingEvent[`ObjectPersistingEvent`]
-
-* xref:rg.adoc#_rg_classes_lifecycleevent_manpage-ObjectRemovingEvent[`ObjectRemovingEvent`]
-
-* xref:rg.adoc#_rg_classes_lifecycleevent_manpage-ObjectUpdatedEvent[`ObjectUpdatedEvent`]
-
-* xref:rg.adoc#_rg_classes_lifecycleevent_manpage-ObjectUpdatingEvent[`ObjectUpdatingEvent`]
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent_manpage-ObjectCreatedEvent.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent_manpage-ObjectCreatedEvent.adoc b/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent_manpage-ObjectCreatedEvent.adoc
deleted file mode 100644
index f0a1ee2..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent_manpage-ObjectCreatedEvent.adoc
+++ /dev/null
@@ -1,20 +0,0 @@
-[[_rg_classes_lifecycleevent_manpage-ObjectCreatedEvent]]
-= `ObjectCreatedEvent`
-: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/
-
-
-
-Subclass of xref:rg.adoc#_rg_classes_lifecycleevent_manpage-AbstractLifecycleEvent[`AbstractLifecycleEvent`], broadcast
-when an object is first instantiated using the
-xref:rgsvc.adoc#_rgsvc-api_DomainObjectContainer_object-creation-api[`DomainObjectContainer`]'s
-`#newTransientInstance(...)` method.
-
-`ObjectCreatedEvent.Default` is the concrete implementation that is used.
-
-[NOTE]
-====
-In the future this may be generalized to allow arbitrary subclasses to be broadcast, see ISIS-803.
-====
-
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent_manpage-ObjectLoadedEvent.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent_manpage-ObjectLoadedEvent.adoc b/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent_manpage-ObjectLoadedEvent.adoc
deleted file mode 100644
index 627308a..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent_manpage-ObjectLoadedEvent.adoc
+++ /dev/null
@@ -1,17 +0,0 @@
-[[_rg_classes_lifecycleevent_manpage-ObjectLoadedEvent]]
-= `ObjectLoadedEvent`
-: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/
-
-
-
-Subclass of xref:rg.adoc#_rg_classes_lifecycleevent_manpage-AbstractLifecycleEvent[`AbstractLifecycleEvent`], broadcast
-when an object is retrieved from the database.
-
-`ObjectLoadedEvent.Default` is the concrete implementation that is used.
-
-[NOTE]
-====
-In the future this may be generalized to allow arbitrary subclasses to be broadcast, see ISIS-803.
-====
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent_manpage-ObjectPersistedEvent.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent_manpage-ObjectPersistedEvent.adoc b/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent_manpage-ObjectPersistedEvent.adoc
deleted file mode 100644
index f9dcf46..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent_manpage-ObjectPersistedEvent.adoc
+++ /dev/null
@@ -1,19 +0,0 @@
-[[_rg_classes_lifecycleevent_manpage-ObjectPersistedEvent]]
-= `ObjectPersistedEvent`
-: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/
-
-
-Subclass of xref:rg.adoc#_rg_classes_lifecycleevent_manpage-AbstractLifecycleEvent[`AbstractLifecycleEvent`], broadcast
-when an object is first saved (inserted) into the database using the
-xref:rgsvc.adoc#_rgsvc-api_DomainObjectContainer_object-persistence-api[`DomainObjectContainer`]'s
-`#persist(...)` method.
-
-
-`ObjectPersistedEvent.Default` is the concrete implementation that is used.
-
-[NOTE]
-====
-In the future this may be generalized to allow arbitrary subclasses to be broadcast, see ISIS-803.
-====
http://git-wip-us.apache.org/repos/asf/isis/blob/d0539e43/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent_manpage-ObjectPersistingEvent.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent_manpage-ObjectPersistingEvent.adoc b/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent_manpage-ObjectPersistingEvent.adoc
deleted file mode 100644
index 21ab9f6..0000000
--- a/adocs/documentation/src/main/asciidoc/guides/_rg_classes_lifecycleevent_manpage-ObjectPersistingEvent.adoc
+++ /dev/null
@@ -1,21 +0,0 @@
-[[_rg_classes_lifecycleevent_manpage-ObjectPersistingEvent]]
-= `ObjectPersistingEvent`
-: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/
-
-
-Subclass of xref:rg.adoc#_rg_classes_lifecycleevent_manpage-AbstractLifecycleEvent[`AbstractLifecycleEvent`], broadcast
-when an object is about to be saved (inserted) into the database using the
-xref:rgsvc.adoc#_rgsvc-api_DomainObjectContainer_object-persistence-api[`DomainObjectContainer`]'s
-`#persist(...)` method.
-
-
-`ObjectPersistingEvent.Default` is the concrete implementation that is used.
-
-[NOTE]
-====
-In the future this may be generalized to allow arbitrary subclasses to be broadcast, see ISIS-803.
-====
-
-