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 2018/08/06 09:22:40 UTC
[isis] branch ISIS-1810 updated (52ecca8 -> 7c66895)
This is an automated email from the ASF dual-hosted git repository.
danhaywood pushed a change to branch ISIS-1810
in repository https://gitbox.apache.org/repos/asf/isis.git.
from 52ecca8 ISIS-1810: adds section on meta annotations
new 8ab7ade ISIS-1810: more on migration notes
new 7c66895 ISIS-1810: more on migration notes
The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
.../_migration-notes_1.16.0-to-2.0.0-M1.adoc | 346 ++++++---------------
...-notes_1.16.0-to-2.0.0-M1_meta-annotations.adoc | 97 ++++++
...tes_1.16.0-to-2.0.0-M1_updated-annotations.adoc | 170 ++++++++++
todo-deprecation-list.txt | 6 -
4 files changed, 355 insertions(+), 264 deletions(-)
create mode 100644 adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.16.0-to-2.0.0-M1_meta-annotations.adoc
create mode 100644 adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.16.0-to-2.0.0-M1_updated-annotations.adoc
[isis] 02/02: ISIS-1810: more on migration notes
Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
danhaywood pushed a commit to branch ISIS-1810
in repository https://gitbox.apache.org/repos/asf/isis.git
commit 7c668951745f164680351e63b2f201c1c048f6cc
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Mon Aug 6 10:22:31 2018 +0100
ISIS-1810: more on migration notes
---
.../_migration-notes_1.16.0-to-2.0.0-M1.adoc | 170 +--------------------
...-notes_1.16.0-to-2.0.0-M1_meta-annotations.adoc | 4 +
...tes_1.16.0-to-2.0.0-M1_updated-annotations.adoc | 170 +++++++++++++++++++++
3 files changed, 175 insertions(+), 169 deletions(-)
diff --git a/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.16.0-to-2.0.0-M1.adoc b/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.16.0-to-2.0.0-M1.adoc
index b2a9fe5..726c151 100644
--- a/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.16.0-to-2.0.0-M1.adoc
+++ b/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.16.0-to-2.0.0-M1.adoc
@@ -7,180 +7,12 @@
include::_migration-notes_1.16.0-to-2.0.0-M1_meta-annotations.adoc[leveloffset=+1]
+include::_migration-notes_1.16.0-to-2.0.0-M1_updated-annotations.adoc[leveloffset=+1]
-
-
-[[__migration-notes_1.15.0-to-1.16.0_updated-annotations]]
-== Updated annotations
-
-Prior to v2.0.0, several annotation attributes were defined as booleans.
-In order to support xref:migration-notes.adoc#__migration-notes_1.15.0-to-1.16.0_meta-annotations[meta annotations], these have been replaced by enums which also include a `NOT_SPECIFIED` value.
-Other enums have been extended (where necessary) to also have a `NOT_SPECIFIED` value.
-In all cases `NOT_SPECIFIED` is the new default.
-
-
-.Updated annotations
-[cols="1a,1a,3a", options="header"]
-|===
-
-| Annotation
-| Updated attribute
-| Nature of change
-
-.7+|xref:../guides/rgant/rgant.adoc#_rgant-Action[`@Action`]
-
-|xref:../guides/rgant/rgant.adoc#_rgant-Action_command[`command`]
-| Default changed from `AS_CONFIGURED` to `NOT_SPECIFIED`.
-
-| xref:../guides/rgant/rgant.adoc#_rgant-Action_hidden[`hidden`]
-| Default changed from `NOWHERE` to `NOT_SPECIFIED`.
-
-| xref:../guides/rgant/rgant.adoc#_rgant-Action_invokeOn[`invokeOn`]
-| Default changed from `OBJECT_ONLY` to `NOT_SPECIFIED`.
-
-| xref:../guides/rgant/rgant.adoc#_rgant-Action_publishing[`publishing`]
-| Default changed from `AS_CONFIGURED` to `NOT_SPECIFIED`.
-
-| xref:../guides/rgant/rgant.adoc#_rgant-Action_publishing[`publishing`]
-| Default changed from `AS_CONFIGURED` to `NOT_SPECIFIED`.
-
-| xref:../guides/rgant/rgant.adoc#_rgant-Action_restrictTo[`restrictTo`]
-| Default changed from `NO_RESTRICTIONS` to `NOT_SPECIFIED`.
-
-| xref:../guides/rgant/rgant.adoc#_rgant-Action_semantics[`semantics`]
-| Default changed from `NON_IDEMPOTENT` to `NOT_SPECIFIED`.
-
-
-
-.3+|xref:../guides/rgant/rgant.adoc#_rgant-ActionLayout[`@ActionLayout`]
-
-| xref:../guides/rgant/rgant.adoc#_rgant-ActionLayout_bookmarking[`bookmarking`]
-| Default changed from `NEVER` to `NOT_SPECIFIED`.
-
-| xref:../guides/rgant/rgant.adoc#_rgant-ActionLayout_contributed[`contributed`]
-| Default changed from `AS_BOTH` to `NOT_SPECIFIED`.
-
-| xref:../guides/rgant/rgant.adoc#_rgant-ActionLayout_position[`position`]
-| Default changed from `BELOW` to `NOT_SPECIFIED`.
-
-
-.3+|xref:../guides/rgant/rgant.adoc#_rgant-Collection[`@Collection`]
-
-| xref:../guides/rgant/rgant.adoc#_rgant-Collection_hidden[`hidden`]
-| Default changed from `NOWHERE` to `NOT_SPECIFIED`.
-
-| xref:../guides/rgant/rgant.adoc#_rgant-Collection_editing[`editing`]
-| Default changed from `AS_CONFIGURED` to `NOT_SPECIFIED`.
-
-| xref:../guides/rgant/rgant.adoc#_rgant-Collection_mementoSerialization[`mementoSerialization`]
-| Replaces `notPersisted`, taking values of `INCLUDED`, `EXCLUDED` or `NOT_SPECIFIED`.
-Defaults to `NOT_SPECIFIED`.
-
-
-
-.4+|xref:../guides/rgant/rgant.adoc#_rgant-DomainObject[`@DomainObject`]
-
-
-| xref:../guides/rgant/rgant.adoc#_rgant-DomainObject_auditing[`auditing`]
-| Default changed from `AS_CONFIGURED` to `NOT_SPECIFIED`.
-
-| xref:../guides/rgant/rgant.adoc#_rgant-DomainObject_bounding[`bounding`]
-| Replaces `bounded`, taking values of `BOUNDED`, `UNBOUNDED` and `NOT_SPECIFIED`.
-Defaults to `NOT_SPECIFIED`.
-
-| xref:../guides/rgant/rgant.adoc#_rgant-DomainObject_editing[`editing`]
-| Default changed from `AS_CONFIGURED` to `NOT_SPECIFIED`.
-
-| xref:../guides/rgant/rgant.adoc#_rgant-DomainObject_publishing[`publishing`]
-| Default changed from `AS_CONFIGURED` to `NOT_SPECIFIED`.
-
-
-
-.1+|xref:../guides/rgant/rgant.adoc#_rgant-DomainObjectLayout[`@DomainObjectLayout`]
-
-| xref:../guides/rgant/rgant.adoc#_rgant-DomainObjectLayout_bookmarking[`bookmarking`]
-| Default changed from `NEVER` to `NOT_SPECIFIED`.
-
-
-.1+|xref:../guides/rgant/rgant.adoc#_rgant-Parameter[`@Parameter`]
-[cols="1a,3a", options="header"]
-
-
-| xref:../guides/rgant/rgant.adoc#_rgant-Parameter_optionality[`optionality`]
-| Default changed from `DEFAULT` to `NOT_SPECIFIED`.
-
-
-
-.2+|xref:../guides/rgant/rgant.adoc#_rgant-ParameterLayout[`@ParameterLayout`]
-
-| xref:../guides/rgant/rgant.adoc#_rgant-ParameterLayout_labelPosition[`labelPosition`]
-| Default changed from `DEFAULT` to `NOT_SPECIFIED`.
-
-| xref:../guides/rgant/rgant.adoc#_rgant-ParameterLayout_renderDay[`renderDay`]
-| Replaces `renderedAsDayBefore`, taking values of `AS_DAY`, `AS_DAY_BEFORE` or `NOT_SPECIFIED`.
-Defaults to `NOT_SPECIFIED`.
-
-
-.6+|xref:../guides/rgant/rgant.adoc#_rgant-Property[`@Property`]
-
-
-| xref:../guides/rgant/rgant.adoc#_rgant-Property_commandReification[`commandReification`]
-| Default changed from `AS_CONFIGURED` to `NOT_SPECIFIED`.
-
-| xref:../guides/rgant/rgant.adoc#_rgant-Property_editing[`editing`]
-| Default changed from `AS_CONFIGURED` to `NOT_SPECIFIED`.
-
-| xref:../guides/rgant/rgant.adoc#_rgant-Property_hidden[`hidden`]
-| Default changed from `NOWHERE` to `NOT_SPECIFIED`.
-
-| xref:../guides/rgant/rgant.adoc#_rgant-Property_mementoSerialization[`mementoSerialization`]
-| Replaces `notPersisted`, taking values of `INCLUDED`, `EXCLUDED` or `NOT_SPECIFIED`.
-Defaults to `NOT_SPECIFIED`.
-
-| xref:../guides/rgant/rgant.adoc#_rgant-Property_optionality[`optionality`]
-| Default changed from `DEFAULT` to `NOT_SPECIFIED`.
-
-| xref:../guides/rgant/rgant.adoc#_rgant-Property_publishing[`publishing`]
-| Default changed from `AS_CONFIGURED` to `NOT_SPECIFIED`.
-
-
-
-.5+|xref:../guides/rgant/rgant.adoc#_rgant-PropertyLayout[`@PropertyLayout`]
-
-| xref:../guides/rgant/rgant.adoc#_rgant-PropertyLayout_labelPosition[`labelPosition`]
-| Default changed from `DEFAULT` to `NOT_SPECIFIED`.
-
-
-| xref:../guides/rgant/rgant.adoc#_rgant-PropertyLayout_promptStyle[`promptStyle`]
-| Default changed from `DEFAULT` to `NOT_SPECIFIED`.
-
-
-| xref:../guides/rgant/rgant.adoc#_rgant-PropertyLayout_renderDay[`renderDay`]
-| Replaces `notPersisted`, taking values of `AS_DAY`, `AS_DAY_BEFORE` or `NOT_SPECIFIED`.
-Defaults to `NOT_SPECIFIED`.
-
-
-| xref:../guides/rgant/rgant.adoc#_rgant-PropertyLayout_repainting[`repainting`]
-| Replaces `unchanging`, taking values of `REPAINT`, `NO_REPAINT` or `NOT_SPECIFIED`.
-Defaults to `NOT_SPECIFIED`.
-
-
-
-.1+|xref:../guides/rgant/rgant.adoc#_rgant-ViewModelLayout[`@ViewModelLayout`]
-
-| xref:../guides/rgant/rgant.adoc#_rgant-ViewModelLayout_bookmarking[`bookmarking`]
-| adds new NOT_SPECIFIED value
-
-
-|===
-
-
-
-
[[__migration-notes_1.15.0-to-1.16.0_removed-annotations]]
== Removed annotations/attributes
diff --git a/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.16.0-to-2.0.0-M1_meta-annotations.adoc b/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.16.0-to-2.0.0-M1_meta-annotations.adoc
index 6e98402..90f31e1 100644
--- a/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.16.0-to-2.0.0-M1_meta-annotations.adoc
+++ b/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.16.0-to-2.0.0-M1_meta-annotations.adoc
@@ -1,5 +1,9 @@
[[_migration-notes_1.15.0-to-1.16.0_meta-annotations]]
= Meta annotations
+: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 ag [...]
+:_basedir: ../
+:_imagesdir: images/
+
Most of the Apache Isis annotations can now be associated with meta-annotations.
Coupled with the fact that DataNucleus 5.x also supports meta annotations, this therefore allows a degree of reuse.
diff --git a/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.16.0-to-2.0.0-M1_updated-annotations.adoc b/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.16.0-to-2.0.0-M1_updated-annotations.adoc
new file mode 100644
index 0000000..772b4b3
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.16.0-to-2.0.0-M1_updated-annotations.adoc
@@ -0,0 +1,170 @@
+[[_migration-notes_1.15.0-to-1.16.0_updated-annotations]]
+= Updated annotations
+: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 ag [...]
+:_basedir: ../
+:_imagesdir: images/
+
+
+
+Prior to v2.0.0, several annotation attributes were defined as booleans.
+In order to support xref:migration-notes.adoc#__migration-notes_1.15.0-to-1.16.0_meta-annotations[meta annotations], these have been replaced by enums which also include a `NOT_SPECIFIED` value.
+Other enums have been extended (where necessary) to also have a `NOT_SPECIFIED` value.
+In all cases `NOT_SPECIFIED` is the new default.
+
+
+.Updated annotations
+[cols="1a,1a,3a", options="header"]
+|===
+
+| Annotation
+| Updated attribute
+| Nature of change
+
+.7+|xref:../guides/rgant/rgant.adoc#_rgant-Action[`@Action`]
+
+|xref:../guides/rgant/rgant.adoc#_rgant-Action_command[`command`]
+| Default changed from `AS_CONFIGURED` to `NOT_SPECIFIED`.
+
+| xref:../guides/rgant/rgant.adoc#_rgant-Action_hidden[`hidden`]
+| Default changed from `NOWHERE` to `NOT_SPECIFIED`.
+
+| xref:../guides/rgant/rgant.adoc#_rgant-Action_invokeOn[`invokeOn`]
+| Default changed from `OBJECT_ONLY` to `NOT_SPECIFIED`.
+
+| xref:../guides/rgant/rgant.adoc#_rgant-Action_publishing[`publishing`]
+| Default changed from `AS_CONFIGURED` to `NOT_SPECIFIED`.
+
+| xref:../guides/rgant/rgant.adoc#_rgant-Action_publishing[`publishing`]
+| Default changed from `AS_CONFIGURED` to `NOT_SPECIFIED`.
+
+| xref:../guides/rgant/rgant.adoc#_rgant-Action_restrictTo[`restrictTo`]
+| Default changed from `NO_RESTRICTIONS` to `NOT_SPECIFIED`.
+
+| xref:../guides/rgant/rgant.adoc#_rgant-Action_semantics[`semantics`]
+| Default changed from `NON_IDEMPOTENT` to `NOT_SPECIFIED`.
+
+
+
+.3+|xref:../guides/rgant/rgant.adoc#_rgant-ActionLayout[`@ActionLayout`]
+
+| xref:../guides/rgant/rgant.adoc#_rgant-ActionLayout_bookmarking[`bookmarking`]
+| Default changed from `NEVER` to `NOT_SPECIFIED`.
+
+| xref:../guides/rgant/rgant.adoc#_rgant-ActionLayout_contributed[`contributed`]
+| Default changed from `AS_BOTH` to `NOT_SPECIFIED`.
+
+| xref:../guides/rgant/rgant.adoc#_rgant-ActionLayout_position[`position`]
+| Default changed from `BELOW` to `NOT_SPECIFIED`.
+
+
+.3+|xref:../guides/rgant/rgant.adoc#_rgant-Collection[`@Collection`]
+
+| xref:../guides/rgant/rgant.adoc#_rgant-Collection_hidden[`hidden`]
+| Default changed from `NOWHERE` to `NOT_SPECIFIED`.
+
+| xref:../guides/rgant/rgant.adoc#_rgant-Collection_editing[`editing`]
+| Default changed from `AS_CONFIGURED` to `NOT_SPECIFIED`.
+
+| xref:../guides/rgant/rgant.adoc#_rgant-Collection_mementoSerialization[`mementoSerialization`]
+| Replaces `notPersisted`, taking values of `INCLUDED`, `EXCLUDED` or `NOT_SPECIFIED`.
+Defaults to `NOT_SPECIFIED`.
+
+
+
+.4+|xref:../guides/rgant/rgant.adoc#_rgant-DomainObject[`@DomainObject`]
+
+
+| xref:../guides/rgant/rgant.adoc#_rgant-DomainObject_auditing[`auditing`]
+| Default changed from `AS_CONFIGURED` to `NOT_SPECIFIED`.
+
+| xref:../guides/rgant/rgant.adoc#_rgant-DomainObject_bounding[`bounding`]
+| Replaces `bounded`, taking values of `BOUNDED`, `UNBOUNDED` and `NOT_SPECIFIED`.
+Defaults to `NOT_SPECIFIED`.
+
+| xref:../guides/rgant/rgant.adoc#_rgant-DomainObject_editing[`editing`]
+| Default changed from `AS_CONFIGURED` to `NOT_SPECIFIED`.
+
+| xref:../guides/rgant/rgant.adoc#_rgant-DomainObject_publishing[`publishing`]
+| Default changed from `AS_CONFIGURED` to `NOT_SPECIFIED`.
+
+
+
+.1+|xref:../guides/rgant/rgant.adoc#_rgant-DomainObjectLayout[`@DomainObjectLayout`]
+
+| xref:../guides/rgant/rgant.adoc#_rgant-DomainObjectLayout_bookmarking[`bookmarking`]
+| Default changed from `NEVER` to `NOT_SPECIFIED`.
+
+
+.1+|xref:../guides/rgant/rgant.adoc#_rgant-Parameter[`@Parameter`]
+[cols="1a,3a", options="header"]
+
+
+| xref:../guides/rgant/rgant.adoc#_rgant-Parameter_optionality[`optionality`]
+| Default changed from `DEFAULT` to `NOT_SPECIFIED`.
+
+
+
+.2+|xref:../guides/rgant/rgant.adoc#_rgant-ParameterLayout[`@ParameterLayout`]
+
+| xref:../guides/rgant/rgant.adoc#_rgant-ParameterLayout_labelPosition[`labelPosition`]
+| Default changed from `DEFAULT` to `NOT_SPECIFIED`.
+
+| xref:../guides/rgant/rgant.adoc#_rgant-ParameterLayout_renderDay[`renderDay`]
+| Replaces `renderedAsDayBefore`, taking values of `AS_DAY`, `AS_DAY_BEFORE` or `NOT_SPECIFIED`.
+Defaults to `NOT_SPECIFIED`.
+
+
+.6+|xref:../guides/rgant/rgant.adoc#_rgant-Property[`@Property`]
+
+
+| xref:../guides/rgant/rgant.adoc#_rgant-Property_commandReification[`commandReification`]
+| Default changed from `AS_CONFIGURED` to `NOT_SPECIFIED`.
+
+| xref:../guides/rgant/rgant.adoc#_rgant-Property_editing[`editing`]
+| Default changed from `AS_CONFIGURED` to `NOT_SPECIFIED`.
+
+| xref:../guides/rgant/rgant.adoc#_rgant-Property_hidden[`hidden`]
+| Default changed from `NOWHERE` to `NOT_SPECIFIED`.
+
+| xref:../guides/rgant/rgant.adoc#_rgant-Property_mementoSerialization[`mementoSerialization`]
+| Replaces `notPersisted`, taking values of `INCLUDED`, `EXCLUDED` or `NOT_SPECIFIED`.
+Defaults to `NOT_SPECIFIED`.
+
+| xref:../guides/rgant/rgant.adoc#_rgant-Property_optionality[`optionality`]
+| Default changed from `DEFAULT` to `NOT_SPECIFIED`.
+
+| xref:../guides/rgant/rgant.adoc#_rgant-Property_publishing[`publishing`]
+| Default changed from `AS_CONFIGURED` to `NOT_SPECIFIED`.
+
+
+
+.5+|xref:../guides/rgant/rgant.adoc#_rgant-PropertyLayout[`@PropertyLayout`]
+
+| xref:../guides/rgant/rgant.adoc#_rgant-PropertyLayout_labelPosition[`labelPosition`]
+| Default changed from `DEFAULT` to `NOT_SPECIFIED`.
+
+
+| xref:../guides/rgant/rgant.adoc#_rgant-PropertyLayout_promptStyle[`promptStyle`]
+| Default changed from `DEFAULT` to `NOT_SPECIFIED`.
+
+
+| xref:../guides/rgant/rgant.adoc#_rgant-PropertyLayout_renderDay[`renderDay`]
+| Replaces `notPersisted`, taking values of `AS_DAY`, `AS_DAY_BEFORE` or `NOT_SPECIFIED`.
+Defaults to `NOT_SPECIFIED`.
+
+
+| xref:../guides/rgant/rgant.adoc#_rgant-PropertyLayout_repainting[`repainting`]
+| Replaces `unchanging`, taking values of `REPAINT`, `NO_REPAINT` or `NOT_SPECIFIED`.
+Defaults to `NOT_SPECIFIED`.
+
+
+
+.1+|xref:../guides/rgant/rgant.adoc#_rgant-ViewModelLayout[`@ViewModelLayout`]
+
+| xref:../guides/rgant/rgant.adoc#_rgant-ViewModelLayout_bookmarking[`bookmarking`]
+| adds new NOT_SPECIFIED value
+
+
+|===
+
+
[isis] 01/02: ISIS-1810: more on migration notes
Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
danhaywood pushed a commit to branch ISIS-1810
in repository https://gitbox.apache.org/repos/asf/isis.git
commit 8ab7adece402c68d5091ea0eabd9213afa937cde
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Mon Aug 6 10:20:14 2018 +0100
ISIS-1810: more on migration notes
---
.../_migration-notes_1.16.0-to-2.0.0-M1.adoc | 182 ++++++++++-----------
...-notes_1.16.0-to-2.0.0-M1_meta-annotations.adoc | 93 +++++++++++
todo-deprecation-list.txt | 6 -
3 files changed, 183 insertions(+), 98 deletions(-)
diff --git a/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.16.0-to-2.0.0-M1.adoc b/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.16.0-to-2.0.0-M1.adoc
index 07a819e..b2a9fe5 100644
--- a/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.16.0-to-2.0.0-M1.adoc
+++ b/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.16.0-to-2.0.0-M1.adoc
@@ -6,99 +6,11 @@
+include::_migration-notes_1.16.0-to-2.0.0-M1_meta-annotations.adoc[leveloffset=+1]
-[[__migration-notes_1.15.0-to-1.16.0_meta-annotations]]
-== Meta annotations
-Most of the Apache Isis annotations can now be associated with meta-annotations.
-Coupled with the fact that DataNucleus 5.x also supports meta annotations, this therefore allows a degree of reuse.
-
-For example, instead of:
-
-[source,java]
-----
-@Column(length=30)
-@Property(regex=...)
-@Getter @Setter
-private String name;
-
-public Customer updateName(
- @Parameter(maxLength=30, regex=...)
- String name ) {
- setName(name);
-}
-----
-
-we can instead define a `@Name` annotation:
-
-
-[source,java]
-----
-@Column(length=30)
-@Property(regex=...)
-@Parameter(maxLength=30, regex=...)
-public @interface @Name {}
-----
-
-and then use this annotation:
-
-[source,java]
-----
-@Name
-@Getter @Setter
-private String name;
-
-public Customer updateName(
- @Name
- String name ) {
- setName(name);
-}
-----
-
-The full list of Apache Isis annotations that can be used in meta-annotations is shown in the table below.
-
-.Apache Isis annotations that can be used in meta-annotations
-[cols="1a,1a,1a", options="header"]
-|===
-
-|
-| Domain layer
-| UI layer
-
-
-|domain service
-|xref:../guides/rgant/rgant.adoc#_rgant-DomainService[@DomainService]
-|xref:../guides/rgant/rgant.adoc#_rgant-DomainServiceLayout[@DomainServiceLayout]
-
-|domain object
-|xref:../guides/rgant/rgant.adoc#_rgant-DomainObject[@DomainObject] +
-xref:../guides/rgant/rgant.adoc#_rgant-ViewModel[@ViewModel] +
-xref:../guides/rgant/rgant.adoc#_rgant-MemberGroupLayout[@MemberGroupLayout]
-
-|xref:../guides/rgant/rgant.adoc#_rgant-DomainObjectLayout[@DomainObjectLayout] +
-xref:../guides/rgant/rgant.adoc#_rgant-ViewModelLayout[@ViewModelLayout]
-
-| Action
-
-|xref:../guides/rgant/rgant.adoc#_rgant-Action[@Action]
-|xref:../guides/rgant/rgant.adoc#_rgant-ActionLayout[@ActionLayout]
-
-|action parameter
-|xref:../guides/rgant/rgant.adoc#_rgant-Parameter[@Parameter]
-|xref:../guides/rgant/rgant.adoc#_rgant-ParameterLayout[@ParameterLayout]
-
-
-|property
-|xref:../guides/rgant/rgant.adoc#_rgant-Property[@Property]
-|xref:../guides/rgant/rgant.adoc#_rgant-PropertyLayout[@PropertyLayout]
-
-|collection
-|xref:../guides/rgant/rgant.adoc#_rgant-Collection[@Collection]
-|xref:../guides/rgant/rgant.adoc#_rgant-CollectionLayout[@CollectionLayout]
-
-|===
@@ -111,13 +23,13 @@ Other enums have been extended (where necessary) to also have a `NOT_SPECIFIED`
In all cases `NOT_SPECIFIED` is the new default.
-
+.Updated annotations
[cols="1a,1a,3a", options="header"]
|===
| Annotation
-| Modified attribute
-| Change
+| Updated attribute
+| Nature of change
.7+|xref:../guides/rgant/rgant.adoc#_rgant-Action[`@Action`]
@@ -272,6 +184,9 @@ Defaults to `NOT_SPECIFIED`.
[[__migration-notes_1.15.0-to-1.16.0_removed-annotations]]
== Removed annotations/attributes
+The following annotations, or attributes of annotations, have been removed
+
+.Removed annotations/attributes
[cols="1l,1l,3a", options="header"]
|===
@@ -583,6 +498,9 @@ DayBefore
[[__migration-notes_1.15.0-to-1.16.0_removed-interfaces]]
== Removed interfaces
+The following interfaces have been removed.
+
+.Removed interfaces
[cols="1a,3a", options="header"]
|===
@@ -624,3 +542,83 @@ DayBefore
|===
+
+[[__migration-notes_1.15.0-to-1.16.0_updated-classes]]
+== Updated classes
+
+The following classes have been removed.
+
+.Updated classes
+[cols="2l,2a,3a", options="header"]
+|===
+
+| Updated class
+| Method
+| Nature of change
+
+|IsisAppModule.
+ActionDomainEvent
+|N-arg constructor
+|removed; just use the 0-arg ones
+
+|IsisAppModule.
+CollectionDomainEvent
+|N-arg constructor
+|removed; just use the 0-arg ones
+
+|IsisAppModule.
+PropertyDomainEvent
+|N-arg constructor
+|removed; just use the 0-arg ones
+
+|FixtureScript.
+ExecutionContext
+|`asKeyValueMap(String)`
+|Removed; this shouldn't have had public visibility.
+
+|===
+
+
+
+[[__migration-notes_1.15.0-to-1.16.0_removed--classes]]
+== Removed classes
+
+The following adapter classes have been removed.
+
+.Removed adapter classes
+[cols="1l,3a", options="header"]
+|===
+
+| Removed class
+| Replaced with
+
+|AbstractContainedObject
+| No replacement.
+
+|AbstractDomainObject
+| No replacement.
+
+|AbstractFactoryAndRepository
+| No replacement.
+
+|AbstractHomePageDashboardService
+| No replacement.
+
+|===
+
+Also, all classes and interfaces in `org.apache.isis.applib.filter` have been removed.
+Instead, the `java.util.Predicate<T>` interface is used.
+
+For example, `RepositoryService#allMatches(...)` method, which allows client-side filtering of results (typically during prototyping), now has the signature:
+
+[source,java]
+----
+public interface RepositoryService {
+ ...
+ <T> List<T> allMatches(
+ final Class<T> ofType,
+ final Predicate<? super T> predicate,
+ long... range);
+
+}
+----
diff --git a/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.16.0-to-2.0.0-M1_meta-annotations.adoc b/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.16.0-to-2.0.0-M1_meta-annotations.adoc
new file mode 100644
index 0000000..6e98402
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/migration-notes/_migration-notes_1.16.0-to-2.0.0-M1_meta-annotations.adoc
@@ -0,0 +1,93 @@
+[[_migration-notes_1.15.0-to-1.16.0_meta-annotations]]
+= Meta annotations
+
+Most of the Apache Isis annotations can now be associated with meta-annotations.
+Coupled with the fact that DataNucleus 5.x also supports meta annotations, this therefore allows a degree of reuse.
+
+For example, instead of:
+
+[source,java]
+----
+@Column(length=30)
+@Property(regex=...)
+@Getter @Setter
+private String name;
+
+public Customer updateName(
+ @Parameter(maxLength=30, regex=...)
+ String name ) {
+ setName(name);
+}
+----
+
+we can instead define a `@Name` annotation:
+
+
+[source,java]
+----
+@Column(length=30)
+@Property(regex=...)
+@Parameter(maxLength=30, regex=...)
+public @interface @Name {}
+----
+
+and then use this annotation:
+
+[source,java]
+----
+@Name
+@Getter @Setter
+private String name;
+
+public Customer updateName(
+ @Name
+ String name ) {
+ setName(name);
+}
+----
+
+The full list of Apache Isis annotations that can be used in meta-annotations is shown in the table below.
+
+.Apache Isis annotations that can be used in meta-annotations
+[cols="1a,1a,1a", options="header"]
+|===
+
+|
+| Domain layer
+| UI layer
+
+
+|domain service
+|xref:../guides/rgant/rgant.adoc#_rgant-DomainService[@DomainService]
+|xref:../guides/rgant/rgant.adoc#_rgant-DomainServiceLayout[@DomainServiceLayout]
+
+|domain object
+|xref:../guides/rgant/rgant.adoc#_rgant-DomainObject[@DomainObject] +
+xref:../guides/rgant/rgant.adoc#_rgant-ViewModel[@ViewModel] +
+xref:../guides/rgant/rgant.adoc#_rgant-MemberGroupLayout[@MemberGroupLayout]
+
+|xref:../guides/rgant/rgant.adoc#_rgant-DomainObjectLayout[@DomainObjectLayout] +
+xref:../guides/rgant/rgant.adoc#_rgant-ViewModelLayout[@ViewModelLayout]
+
+| Action
+
+|xref:../guides/rgant/rgant.adoc#_rgant-Action[@Action]
+|xref:../guides/rgant/rgant.adoc#_rgant-ActionLayout[@ActionLayout]
+
+|action parameter
+|xref:../guides/rgant/rgant.adoc#_rgant-Parameter[@Parameter]
+|xref:../guides/rgant/rgant.adoc#_rgant-ParameterLayout[@ParameterLayout]
+
+
+|property
+|xref:../guides/rgant/rgant.adoc#_rgant-Property[@Property]
+|xref:../guides/rgant/rgant.adoc#_rgant-PropertyLayout[@PropertyLayout]
+
+|collection
+|xref:../guides/rgant/rgant.adoc#_rgant-Collection[@Collection]
+|xref:../guides/rgant/rgant.adoc#_rgant-CollectionLayout[@CollectionLayout]
+
+|===
+
+
+
diff --git a/todo-deprecation-list.txt b/todo-deprecation-list.txt
index 909b44d..9659c9a 100644
--- a/todo-deprecation-list.txt
+++ b/todo-deprecation-list.txt
@@ -191,11 +191,6 @@ DONE (REMOVED):
org.apache.isis.applib
- AbstractContainedObject.java - entire class
- AbstractDomainObject.java - entire class
- AbstractFactoryAndRepository.java - entire class
-
- AbstractHomePageDashboardService - entire class
@@ -209,7 +204,6 @@ org.apache.isis.applib
-
org.apache.isis.applib.filter
- entire package of Filter classes; use guava Predicate instead.