You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2015/04/27 21:31:55 UTC
[05/11] isis git commit: ISIS-1133: more on the listen.rb,
renaming included .adoc files.
http://git-wip-us.apache.org/repos/asf/isis/blob/08f6b036/adocs/documentation/src/main/asciidoc/user-guide/user-guide_isis-addons.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_isis-addons.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide_isis-addons.adoc
deleted file mode 100644
index a3d780a..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_isis-addons.adoc
+++ /dev/null
@@ -1,44 +0,0 @@
-= Isis Addons (not ASF)
-: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
-
-WARNING: Note that Isis addons, while maintained by Isis committers, are not part of the ASF.
-
-## Command Service (persistence)
-
-### API
-### Isis addons implementation (not ASF)
-
-## Background Command Service
-
-### API
-### Background Execution
-### Isis addons implementation (not ASF)
-
-## Auditing
-
-### Auditing API
-### Isis addons implementation (not ASF)
-
-
-## Publishing Service
-
-### API
-### Isis addons implementation (not ASF)
-### Event Serializer per RO Spec (out-of-date)
-
-## Other Isis Addons
-
-### Developer Utilities (not ASF)
-### Docx Mail merge (not ASF)
-### Excel download/upload (not ASF)
-### Fake Data (not ASF)
-### Poly (not ASF)
-### Security (not ASF)
-### Session Logger (not ASF)
-### Settings (not ASF)
-### String interpolator (not ASF)
-### Tags (not ASF)
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/08f6b036/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference.adoc
deleted file mode 100644
index f8667b5..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference.adoc
+++ /dev/null
@@ -1,25 +0,0 @@
-= Reference
-: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
-
-include::user-guide_reference-recognized-methods.adoc[leveloffset=+1]
-
-include::user-guide_reference-recognized-annotations.adoc[leveloffset=+1]
-
-include::user-guide_reference-recognized-configuration-properties.adoc[leveloffset=+1]
-
-include::user-guide_reference-domain-services.adoc[leveloffset=+1]
-
-include::user-guide_reference-value-types.adoc[leveloffset=+1]
-
-include::user-guide_reference-applib-utility-classes.adoc[leveloffset=+1]
-
-include::user-guide_reference-convenience-superclasses.adoc[leveloffset=+1]
-
-include::user-guide_reference-cmd-line-args.adoc[leveloffset=+1]
-
-include::user-guide_reference-web-xml.adoc[leveloffset=+1]
-
http://git-wip-us.apache.org/repos/asf/isis/blob/08f6b036/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_applib-utility-classes.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_applib-utility-classes.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_applib-utility-classes.adoc
deleted file mode 100644
index f684ebe..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_applib-utility-classes.adoc
+++ /dev/null
@@ -1,144 +0,0 @@
-= Applib Utility 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/
-
-The `org.apache.isis.applib.util` package has a number of simple utility
-classes designed to simplify the coding of some common tasks.
-
-== Title creation
-
-The `TitleBuffer` utility class is intended to make it easy to construct
-title strings (returned from the `title()` method). For example, it has
-overloaded versions of methods called `append()` and `concat()`.
-
-== Reason text creation (for disable and validate methods)
-
-There are two different classes provided to help build reasons returned
-by `disableXxX()` and `validateXxx()` methods:
-
-* the `org.apache.isis.applib.util.ReasonBuffer` helper class
-* the `org.apache.isis.applib.util.Reasons` helper class
-
-For example:
-
-[source,java]
-----
-public class Customer {
- ...
- public String validatePlaceOrder(Product p, int quantity) {
- return Reasons.coalesce(
- whetherCustomerBlacklisted(this),
- whetherProductOutOfStock(p)
- );
- }
-}
-----
-
-Which you use (if any) is up to you.
-
-== ObjectContracts
-
-The `ObjectContracts` test provides a series of methods to make it easy for your domain objects to:
-
-* implement `Comparable` (eg so can be stored in ``java.util.SortedSet``s)
-* implement `toString()`
-* implement `equals()`
-* implement `hashCode()`
-
-For example:
-
-[source,java]
-----
-public class ToDoItem implements Comparable<ToDoItem> {
-
- public boolean isComplete() { ... }
- public LocalDate getDueBy() { ... }
- public String getDescription() { ... }
- public String getOwnedBy() { ... }
-
- public int compareTo(final ToDoItem other) {
- return ObjectContracts.compare(this, other, "complete","dueBy","description");
- }
-
- public String toString() {
- return ObjectContracts.toString(this, "description","complete","dueBy","ownedBy");
- }
-}
-----
-
-[WARNING]
-====
-Note that `ObjectContracts` makes heavy use of Java Reflection. While it's great to get going quickly in prototyping, we recommend you use your IDE to code generate implementations of these methods for production code.
-
-Moreover (and perhaps even more importantly) `ObjectContracts` implementation can cause DataNucleus to recursively rehydrate a larger number of associated entities (More detail below).
-
-We therefore recommend that you disable persistence-by-reachability by adding:
-
-[source,ini]
-.persistor_datanucleus.properties
-----
-#
-# Require explicit persistence (since entities are Comparable and using ObjectContracts#compareTo).
-#
-isis.persistor.datanucleus.impl.datanucleus.persistenceByReachabilityAtCommit=false
-----
-
-====
-
-### Explanation of the issue in more detail
-
-Consider the entities:
-
- Party <->* AgreementRole <*-> Agreement
-
-In the course of a transaction, the `Agreement` entity is loaded into memory (not necessarily modified), and then new ``AgreementRole``s are associated to it.
-
-All these entities implement `Comparable` using `ObjectContracts`, so that the implementation of ``AgreementRole``'s (simplified) is:
-
-[source,java]
-----
-public class AgreementRole {
- ...
- public int compareTo(AgreementRole other) {
- return ObjectContracts.compareTo(this, other, "agreement","startDate","party");
- }
- ...
-}
-----
-
-while ``Agreement``'s is implemented as:
-
-[source,java]
-----
- public class Agreement {
- ...
- public int compareTo(Agreement other) {
- return ObjectContracts.compareTo(this, other, "reference");
- }
- ...
- }
-----
-
-and ``Party``'s is similarly implemented as:
-
-[source,java]
-----
-public class Party {
- ...
- public int compareTo(Party other) {
- return ObjectContracts.compareTo(this, other, "reference");
- }
- ...
-}
-----
-
-DataNucleus's persistence-by-reachability algorithm adds the ``AgreementRole``s into a `SortedSet`, which causes `AgreementRole#compareTo()` to fire:
-
-* the evaluation of the "agreement" property delegates back to the `Agreement`, whose own `Agreement#compareTo()` uses the scalar `reference` property. As the `Agreement` is already in-memory, this does not trigger any further database queries
-
-* the evaluation of the "startDate" property is just a scalar property of the `AgreementRole`, so will already in-memory
-
-* the evaluation of the "party" property delegates back to the `Party`, whose own `Party#compareTo()` requires the uses the scalar `reference` property. However, since the `Party` is not yet in-memory, using the `reference` property triggers a database query to "rehydrate" the `Party` instance.
-
-In other words, figuring out whether `AgreementRole` is comparable requires the persistence-by-reachability algorithm to run, causing the adjacent associated entity `Party` to also be retrieved.
http://git-wip-us.apache.org/repos/asf/isis/blob/08f6b036/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_cmd-line-args.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_cmd-line-args.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_cmd-line-args.adoc
deleted file mode 100644
index 4e52124..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_cmd-line-args.adoc
+++ /dev/null
@@ -1,31 +0,0 @@
-= Command Line Arguments
-: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
-
-
-## `org.apache.isis.WebServer`
-
-For example:
-* `--fixture`
-* `--services`
-
-etc...
-
-
-
-## Recommended JVM Flags
-
-
-for the `WrapperFactory` (uses link:http://www.csg.ci.i.u-tokyo.ac.jp/~chiba/javassist/[Javassist])
-
-using:
-
-[source]
-----
--XX:+CMSClassUnloadingEnabled -XX:+UseConcMarkSweepGC
-----
-
-You can hint the JVM to unload dynamically created classes which ClassLoaders are still around.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/08f6b036/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_convenience-superclasses.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_convenience-superclasses.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_convenience-superclasses.adoc
deleted file mode 100644
index 5a8e956..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_convenience-superclasses.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= Convenience Superclasses
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/08f6b036/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_domain-services.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_domain-services.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_domain-services.adoc
deleted file mode 100644
index 2b1f4de..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_domain-services.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= Domain Services
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/08f6b036/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_recognized-annotations.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_recognized-annotations.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_recognized-annotations.adoc
deleted file mode 100644
index 514a56b..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_recognized-annotations.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= Recognized 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 agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/08f6b036/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_recognized-configuration-properties.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_recognized-configuration-properties.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_recognized-configuration-properties.adoc
deleted file mode 100644
index 6c2105e..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_recognized-configuration-properties.adoc
+++ /dev/null
@@ -1,28 +0,0 @@
-= Recognized Configuration Properties
-: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
-
-
-.Configuration Properties
-[cols="2,1,3", options="header"]
-|===
-|Property
-|Value
-|Description
-
-|`isis.services`
-|`FQCN`,`FQCN2`,...
-|Fully qualified class names of classes to be instantiated as domain services. Each entry can be optionally prefixed by "n:" specifying the relative order on the menu (corresponds to `@DomainServiceLayout#menuOrder()`).
-
-|`isis.services.` `container.disableAutoFlush`
-|`true`,`_false_`
-|Whether the `DomainObjectContainer` should automatically flush pending changes prior to querying (via `allMatches()`, `firstMatch()` and so on).
-
-|`isis.viewer.wicket.` `disableDependentChoiceAutoSelection`
-|`true`,`_false_`
-|For dependent choices (eg category/subcategory), whether the dependent choice should automatically select the first option, or instead should leave empty
-|===
-
http://git-wip-us.apache.org/repos/asf/isis/blob/08f6b036/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_recognized-methods.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_recognized-methods.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_recognized-methods.adoc
deleted file mode 100644
index ceb6a5b..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_recognized-methods.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= Recognized Methods
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/08f6b036/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_value-types.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_value-types.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_value-types.adoc
deleted file mode 100644
index 0808f72..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_value-types.adoc
+++ /dev/null
@@ -1,14 +0,0 @@
-= Value Types
-: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
-
-
-## JDK
-
-## JodaTime
-
-## Isis Applib
-
http://git-wip-us.apache.org/repos/asf/isis/blob/08f6b036/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_web-xml.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_web-xml.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_web-xml.adoc
deleted file mode 100644
index bc6da88..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_reference_web-xml.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= web.xml Configuration
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/08f6b036/adocs/documentation/src/main/asciidoc/user-guide/user-guide_restful-viewer.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_restful-viewer.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide_restful-viewer.adoc
deleted file mode 100644
index 460c570..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_restful-viewer.adoc
+++ /dev/null
@@ -1,35 +0,0 @@
-= Restful Viewer
-: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
-
-## Features
-
-### Restful Objects Specification
-### Pretty printing
-
-
-
-## Configuration
-
-### Honor UI hints
-
-### Suppressing elements of the representations
-
-### Simplified object representation
-
-
-
-## Extending the viewer
-
-Discussed in <<Extending the Restful viewer>>
-
-
-
-## Hints and Tips
-
-### Using Chrome Tools
-
-### AngularJS Tips
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/08f6b036/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing.adoc
deleted file mode 100644
index 3c7b324..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing.adoc
+++ /dev/null
@@ -1,22 +0,0 @@
-= Testing
-: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
-
-include::user-guide_testing-unit-test-support.adoc[leveloffset=+1]
-
-include::user-guide_testing-integ-test-support.adoc[leveloffset=+1]
-
-include::user-guide_testing-bdd-integ-test-support.adoc[leveloffset=+1]
-
-include::user-guide_testing-fixture-scripts.adoc[leveloffset=+1]
-
-include::user-guide_testing-fake-data.adoc[leveloffset=+1]
-
-
-
-
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/08f6b036/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing_bdd-integ-test-support.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing_bdd-integ-test-support.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing_bdd-integ-test-support.adoc
deleted file mode 100644
index 714abc5..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing_bdd-integ-test-support.adoc
+++ /dev/null
@@ -1,7 +0,0 @@
-= BDD/Integ Test 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/
-
-IMPORTANT: TODO
-
http://git-wip-us.apache.org/repos/asf/isis/blob/08f6b036/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing_fake-data.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing_fake-data.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing_fake-data.adoc
deleted file mode 100644
index a31b65b..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing_fake-data.adoc
+++ /dev/null
@@ -1,11 +0,0 @@
-= Fake Data
-: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
-
-WARN: Isis Addons, not ASF.
-
-link:https://github.com/isisaddons/isis-module-fakedata
-
http://git-wip-us.apache.org/repos/asf/isis/blob/08f6b036/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing_fixture-scripts.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing_fixture-scripts.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing_fixture-scripts.adoc
deleted file mode 100644
index d4d3ffe..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing_fixture-scripts.adoc
+++ /dev/null
@@ -1,65 +0,0 @@
-= Fixture Scripts
-: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
-
-
-## API and Usage
-
-IMPORTANT: TODO
-
-## SudoService (1.9.0-SNAPSHOT)
-
-Sometimes in our fixture scripts we want to perform a business action runnin as a particular user. This might be for the usual reason - so that our fixtures accurately reflect the reality of the system with all business constraints enforced using the `WrapperFactory` - or more straightforwardly it might be simply that the action depends on the identity of the user invoking the action.
-
-An example of the latter case is in the link:[todoapp]'s `ToDoItem` class:
-
-[source,java]
-.Production code that depends on current user
-----
-public ToDoItem newToDo(
- @Parameter(regexPattern = "\\w[@&:\\-\\,\\.\\+ \\w]*") @ParameterLayout(named="Description")
- final String description,
- @ParameterLayout(named="Category")
- final Category category,
- @Parameter(optionality = Optionality.OPTIONAL) @ParameterLayout(named="Subcategory")
- final Subcategory subcategory,
- @Parameter(optionality = Optionality.OPTIONAL) @ParameterLayout(named="Due by")
- final LocalDate dueBy,
- @Parameter(optionality = Optionality.OPTIONAL) @ParameterLayout(named="Cost")
- final BigDecimal cost) {
- return newToDo(description, category, subcategory, currentUserName(), dueBy, cost);
-}
-private String currentUserName() {
- return container.getUser().getName(); // <1>
-}
-----
-<1> is the current user.
-
-The fixture for this can use the `SudoService` to run a block of code as a specified user:
-
-[source,java]
-.Fixture Script
-----
-final String description = ...
-final Category category = ...
-final Subcategory subcategory = ...
-final LocalDate dueBy = ...
-final BigDecimal cost = ...
-final Location location = ...
-
-toDoItem = sudoService.sudo(username,
- new Callable<ToDoItem>() {
- @Override
- public ToDoItem call() {
- final ToDoItem toDoItem = wrap(toDoItems).newToDo(
- description, category, subcategory, dueBy, cost);
- wrap(toDoItem).setLocation(location);
- return toDoItem;
- }
- });
-----
-
-Behind the scenes the `SudoService` simply talks to the `DomainObjectContainer` to override the user returned by the `getUser()` API. It is possible to override both users and roles.
http://git-wip-us.apache.org/repos/asf/isis/blob/08f6b036/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing_integ-test-support.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing_integ-test-support.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing_integ-test-support.adoc
deleted file mode 100644
index 399c2e7..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing_integ-test-support.adoc
+++ /dev/null
@@ -1,19 +0,0 @@
-= Integration Test 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/
-
-IMPORTANT: TODO
-
-
-## Introduction
-
-IMPORTANT: TODO
-
-## Using the WrapperFactory
-
-IMPORTANT: TODO
-
-## IsisConfigurationForJdoIntegTests
-
-IMPORTANT: TODO
http://git-wip-us.apache.org/repos/asf/isis/blob/08f6b036/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing_unit-test-support.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing_unit-test-support.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing_unit-test-support.adoc
deleted file mode 100644
index fefae90..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_testing_unit-test-support.adoc
+++ /dev/null
@@ -1,200 +0,0 @@
-= Unit Test 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/
-
-Isis Core provides a number of unit test helpers for you to use (if you wish) to test your domain objects. To use, update the `pom.xml`:
-
-[source,xml]
-----
-<dependency>
- <groupId>org.apache.isis.core</groupId>
- <artifactId>isis-core-unittestsupport</artifactId>
- <scope>test</scope> // <1>
-</dependency>
-----
-<1> Normally `test`; usual Maven scoping rules apply.
-
-
-
-== ``SortedSet``s Contract Test
-
-This contract test automatically checks that all fields of type `java.util.Collection` are declared as `java.util.SortedSet`. In other words, it precludes either `java.util.List` or `java.util.Set` from being used as a collection.
-
-For example, the following passes the contract test:
-
-[source,java]
-----
-public class Department {
- private SortedSet<Employee> employees = new TreeSet<Employee>();
- ...
-}
-----
-
-whereas this would not:
-
-[source,java]
-----
-public class SomeDomainObject {
- private List<Employee> employees = new ArrayList<Employee>();
- ...
-}
-----
-
-If using the JDO/DataNucleus Objectstore then we strongly recommend that you implement this test, for several reasons:
-
-* First, ``Set``s align more closely to the relational model than do `List`s. A `List` must have an additional index to specify order.
-
-* Second, `SortedSet` is preferable to `Set` because then the order is well-defined and predictable (to an end user, to the programmer).
-
-The <<ObjectContracts>> utility class substantially simplifies the task of implementing `Comparable` in your domain classes.
-
-* Third, if the relationship is bidirectional then JDO/Objectstore will automatically maintain the relationship. See link:../components/objectstores/jdo/managed-1-to-m-relationships.html[here] for further discussion.
-
-To use the contract test, subclass `SortedSetsContractTestAbstract`, specifying the root package to search for domain classes.
-
-For example:
-
-[source,java]
-----
-public class SortedSetsContractTestAll extends SortedSetsContractTestAbstract {
-
- public SortedSetsContractTestAll() {
- super("org.estatio.dom");
- withLoggingTo(System.out);
- }
-}
-----
-
-
-
-
-== Injected Services Method Contract Test
-
-It is quite common for some basic services to be injected in a project-specific domain object superclass; for example a `ClockService` might generally be injected everywhere:
-
-[source,java]
-----
-public abstract class EstatioDomainObject {
- protected ClockService clockService;
- public void injectClockService(ClockService clockService) {
- this.clockService = clockService;
- }
-}
-----
-
-If a subclass inadvertantly overrides this method and provides its own `ClockService` field, then the field in the superclass will never initialized. As you might imagine, ``NullPointerException``s could then arise.
-
-This contract test automatically checks that the `injectXxx(...)` method, to allow for injected services, is not overridable, ie `final`.
-
-To use the contract test, , subclass `SortedSetsContractTestAbstract`, specifying the root package to search for domain classes.
-
-For example:
-
-[source,java]
-----
-public class InjectServiceMethodMustBeFinalContractTestAll extends InjectServiceMethodMustBeFinalContractTestAbstract {
-
- public InjectServiceMethodMustBeFinalContractTestAll() {
- super("org.estatio.dom");
- withLoggingTo(System.out);
- }
-}
-----
-
-
-
-
-== Bidirectional Contract Test
-
-This contract test automatically checks that bidirectional 1:m or 1:1 associations are being maintained correctly (assuming that they follow the link:../more-advanced-topics/how-to-04-060-How-to-set-up-and-maintain-bidirectional-relationships.html[mutual registration pattern]
-
-TIP: If using the link:../components/objectstores/jdo/about.html[JDO Object Store], then there is generally no need to programmatically maintain 1:m relationships (indeed it may introduce subtle errors). For more details, see link:../components/objectstores/jdo/managed-1-to-m-relationships.html[here]. Check out the link:../intro/resources/editor-templates.html[Eclipse templates] for further guidance.
-
-For example, suppose that `ParentDomainObject` and `ChildDomainObject` have a 1:m relationship (`ParentDomainObject#children` / `ChildDomainObject#parent`), and also `PeerDomainObject` has a 1:1 relationship with itself (`PeerDomainObject#next` / `PeerDomainObject#previous`).
-
-The following will exercise these relationships:
-
-[source,java]
-----
-public class BidirectionalRelationshipContractTestAll
- extends BidirectionalRelationshipContractTestAbstract {
-
- public BidirectionalRelationshipContractTestAll() {
- super("org.apache.isis.core.unittestsupport.bidir",
- ImmutableMap.<Class<?>,Instantiator>of(
- ChildDomainObject.class, new InstantiatorForChildDomainObject(),
- PeerDomainObject.class, new InstantiatorSimple(PeerDomainObjectForTesting.class)
- ));
- withLoggingTo(System.out);
- }
-}
-----
-
-The first argument to the constructor scopes the search for domain objects; usually this would be something like `"com.mycompany.dom"`.
-
-The second argument provides a map of `Instantiator` for certain of the domain object types. This has two main purposes. First, for abstract classes, it nominates an alternative concrete class to be instantiated. Second, for classes (such as `ChildDomainObject`) that are `Comparable` and are held in a `SortedSet`), it provides the ability to ensure that different instances are unique when compared against each other. If no `Instantiator` is provided, then the contract test simply attempts to instantiates the class.
-
-If any of the supporting methods (`addToXxx()`, `removeFromXxx()`, `modifyXxx()` or `clearXxx()`) are missing, the relationship is skipped.
-
-To see what's going on (and to identify any skipped relationships), use the `withLoggingTo()` method call. If any assertion fails then the error should be descriptive enough to figure out the problem (without enabling logging).
-
-The example tests can be found https://github.com/apache/isis/tree/master/core/unittestsupport/src/test/java/org/apache/isis/core/unittestsupport/bidir[here].
-
-
-
-
-== JMock Extensions
-
-`JUnitRuleMockery2` is an extension to the JMock's `JunitRuleMockery`, providing a simpler API and also providing support for autowiring.
-
-For example, here we see that the class under test, an instance of `CollaboratingUsingSetterInjection`, is automatically wired up with its `Collaborator`:
-
-[source,java]
-----
-public class JUnitRuleMockery2Test_autoWiring_setterInjection_happyCase {
-
- @Rule
- public JUnitRuleMockery2 context = JUnitRuleMockery2.createFor(Mode.INTERFACES_AND_CLASSES);
-
- @Mock
- private Collaborator collaborator;
-
- @ClassUnderTest
- private CollaboratingUsingSetterInjection collaborating;
-
- @Test
- public void wiring() {
- assertThat(collaborating.collaborator, is(not(nullValue())));
- }
-}
-----
-
-The example tests can be found https://github.com/apache/isis/tree/master/core/unittestsupport/src/test/java/org/apache/isis/core/unittestsupport/jmocking[here]
-
-
-
-
-== Value Objects Contract Test
-
-The `ValueTypeContractTestAbstract` automatically tests that a custom value type implements `equals()` and `hashCode()` correctly.
-
-For example, testing JDK's own `java.math.BigInteger` can be done as follows:
-
-[source,java]
-----
-public class ValueTypeContractTestAbstract_BigIntegerTest extends ValueTypeContractTestAbstract<BigInteger> {
-
- @Override
- protected List<BigInteger> getObjectsWithSameValue() {
- return Arrays.asList(new BigInteger("1"), new BigInteger("1"));
- }
-
- @Override
- protected List<BigInteger> getObjectsWithDifferentValue() {
- return Arrays.asList(new BigInteger("2"));
- }
-}
-----
-
-The example unit tests can be found https://github.com/apache/isis/tree/master/core/unittestsupport/src/test/java/org/apache/isis/core/unittestsupport/value[here].
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/isis/blob/08f6b036/adocs/documentation/src/main/asciidoc/user-guide/user-guide_troubleshooting.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_troubleshooting.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide_troubleshooting.adoc
deleted file mode 100644
index 9be7d78..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_troubleshooting.adoc
+++ /dev/null
@@ -1,13 +0,0 @@
-= Trouble Shooting
-: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
-
-## JDO/DataNucleus Logging
-
-include::user-guide_troubleshooting-datanucleus-logging.adoc[leveloffset=+1]
-
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/08f6b036/adocs/documentation/src/main/asciidoc/user-guide/user-guide_troubleshooting_datanucleus-logging.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_troubleshooting_datanucleus-logging.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide_troubleshooting_datanucleus-logging.adoc
deleted file mode 100644
index b6023b0..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_troubleshooting_datanucleus-logging.adoc
+++ /dev/null
@@ -1,10 +0,0 @@
-= Trouble Shooting: DataNucleus Logging
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-
-
-
http://git-wip-us.apache.org/repos/asf/isis/blob/08f6b036/adocs/documentation/src/main/asciidoc/user-guide/user-guide_wicket-viewer.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_wicket-viewer.adoc b/adocs/documentation/src/main/asciidoc/user-guide/user-guide_wicket-viewer.adoc
deleted file mode 100644
index 73fb31c..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/user-guide_wicket-viewer.adoc
+++ /dev/null
@@ -1,74 +0,0 @@
-= Wicket Viewer
-: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
-
-## Features/end-user usage
-
-### File upload/download
-
-### Bookmarked pages (sliding panel)
-
-### Recent pages (drop down)
-
-### Hints and copy URL
-
-### User Registration
-
-
-
-## Configuration
-
-### Brand logo
-
-### Suppressing 'sign up'
-
-### Suppressing 'password reset'
-
-### Suppressing 'remember me'
-
-### Number of bookmarked pages
-
-### Stripped Wicket tags
-
-### Disabling modal dialogs
-
-### Showing a theme chooser
-
-### Suppressing header and footer (embedded view)
-
-
-
-## Application-specific Customisation
-
-### Customising the Welcome page
-
-### Customising the About page
-
-### Specifying a default theme
-
-### Tweaking CSS classes
-
-### Custom Javascript
-
-### Auto-refresh page
-
-
-
-## Extending the viewer
-
-Discussed in <<Extending the Wicket viewer>>
-
-
-
-## Isis Add-ons (not ASF)
-
-### Excel download
-
-### Fullcalendar2
-
-### Gmap3
-
-### Wicked charts
\ No newline at end of file