You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2015/05/05 21:51:22 UTC
svn commit: r1677885 [3/4] - in /isis/site/trunk/content: ./
components/objectstores/jdo/ components/security/shiro/
components/viewers/restfulobjects/ components/viewers/wicket/ config/
contributors/ core/ how-tos/ intro/elevator-pitch/ intro/getting-...
Modified: isis/site/trunk/content/more-advanced-topics/how-to-suppress-contributions-to-action-parameter.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/more-advanced-topics/how-to-suppress-contributions-to-action-parameter.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/more-advanced-topics/how-to-suppress-contributions-to-action-parameter.md (original)
+++ isis/site/trunk/content/more-advanced-topics/how-to-suppress-contributions-to-action-parameter.md Tue May 5 19:51:18 2015
@@ -1,6 +1,8 @@
How to suppress contributions to action parameters
------------------------------------------------
+[//]: # (content copied to _user-guide_xxx)
+
If a contributed action has multiple parameters, then that action will be contributed to each of the parameter types.
While this will often be what you want (or at least harmless), on some occasions you may want to suppress the contributed
action on one of those parameter types.
Modified: isis/site/trunk/content/more-advanced-topics/multi-tenancy.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/more-advanced-topics/multi-tenancy.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/more-advanced-topics/multi-tenancy.md (original)
+++ isis/site/trunk/content/more-advanced-topics/multi-tenancy.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: Multi-Tenancy support (1.8.0)
+[//]: # (content copied to _user-guide_xxx)
+
## Theory
Sometimes data belonging to one population of users should not be visible to another population
Modified: isis/site/trunk/content/more-thanks.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/more-thanks.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/more-thanks.md (original)
+++ isis/site/trunk/content/more-thanks.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: More Thanks
+[//]: # (content copied to _user-guide_xxx)
+
In addition to the [support given to Apache Foundation as a whole](http://www.apache.org/foundation/thanks.html), the Isis community would also like to extend our thanks to:
<table class="table table-bordered table-condensed table-hover">
Modified: isis/site/trunk/content/other/jrebel.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/other/jrebel.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/other/jrebel.md (original)
+++ isis/site/trunk/content/other/jrebel.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: JRebel plugin (hot redeploys)
+[//]: # (content copied to _user-guide_xxx)
+
The Apache Isis JRebel plugin for [JRebel](http://zeroturnaround.com/software/jrebel/) allows you to alter the domain classes in your development environment and have the running app pick up those changes (avoiding a restart).
JRebel monitors the compiled bytecode of the domain object classes, and reloads whenever these are changed. The Isis plugin then recreates the Isis and JDO metamodels automatically.
Modified: isis/site/trunk/content/other/maven-plugin.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/other/maven-plugin.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/other/maven-plugin.md (original)
+++ isis/site/trunk/content/other/maven-plugin.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: Maven Plugin
+[//]: # (content copied to _user-guide_xxx)
+
{stub
This page is a stub.
}
Modified: isis/site/trunk/content/reference/DomainObjectContainer.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/DomainObjectContainer.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/DomainObjectContainer.md (original)
+++ isis/site/trunk/content/reference/DomainObjectContainer.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
title: DomainObjectContainer interface
+[//]: # (content copied to _user-guide_xxx)
+
> Provides a single point of contact from domain objects into the
> *Apache Isis* framework.
Modified: isis/site/trunk/content/reference/Event.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/Event.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/Event.md (original)
+++ isis/site/trunk/content/reference/Event.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
title: Events
+[//]: # (content copied to _user-guide_xxx)
+
> The InteractionEvent hierarchy.
Although not supported by the default programming model, the applib
Modified: isis/site/trunk/content/reference/Recognized-Methods-and-Prefixes.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/Recognized-Methods-and-Prefixes.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/Recognized-Methods-and-Prefixes.md (original)
+++ isis/site/trunk/content/reference/Recognized-Methods-and-Prefixes.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
title: Recognized Methods and Prefixes
+[//]: # (content copied to _user-guide_xxx)
+
The following table lists all of the methods or method prefixes that are
recognized by *Apache Isis*' default programming model:
Modified: isis/site/trunk/content/reference/Security.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/Security.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/Security.md (original)
+++ isis/site/trunk/content/reference/Security.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
title: Security Classes
+[//]: # (content copied to _user-guide_xxx)
+
> A simple set of classes to represent the currently logged on user and
> their roles.
Modified: isis/site/trunk/content/reference/configuration-files.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/configuration-files.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/configuration-files.md (original)
+++ isis/site/trunk/content/reference/configuration-files.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: Configuration Files
+[//]: # (content copied to _user-guide_xxx)
+
Isis has one mandatory configuration file, `isis.properties`. For the webapp viewers, this typically lives alongside the `web.xml` file in the `WEB-INF` directory.
In addition, Isis will also read from a number of supplementary configuration files (if present), for each of the configured components. For example:
Modified: isis/site/trunk/content/reference/deployment-type.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/deployment-type.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/deployment-type.md (original)
+++ isis/site/trunk/content/reference/deployment-type.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: Deployment Types
+[//]: # (content copied to _user-guide_xxx)
+
The `deploymentType` configuration setting is used to specify whether Isis is running in development mode or production mode (similar to Apache Wicket's concept of the application's [configuration type](http://ci.apache.org/projects/wicket/apidocs/6.0.x/org/apache/wicket/Application.html#getConfigurationType()).
The most notable thing that varies by `deploymentType` is simply whether actions annotated with [@Prototype](./recognized-annotations/Prototype-deprecated.html) are visible.
Modified: isis/site/trunk/content/reference/externalized-configuration.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/externalized-configuration.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/externalized-configuration.md (original)
+++ isis/site/trunk/content/reference/externalized-configuration.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: Externalized Configuration
+[//]: # (content copied to _user-guide_xxx)
+
As described [here](./configuration-files.html), Isis itself bootstraps from the `isis.properties` configuration file.
It will also read configuration from the (optional) component/implementation-specific configuration files (such as
`persistor_datanucleus.properties` or `viewer_wicket.properties`) and also (otional) component-specific configuration
Modified: isis/site/trunk/content/reference/jvm-args.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/jvm-args.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/jvm-args.md (original)
+++ isis/site/trunk/content/reference/jvm-args.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: Suggested JVM args
+[//]: # (content copied to _user-guide_xxx)
+
The default JVM configuration will most likely not be appropriate for running Isis as a webapp. Some args that you will
<table class="table table-striped table-bordered">
Modified: isis/site/trunk/content/reference/object-lifecycle-callbacks.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/object-lifecycle-callbacks.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/object-lifecycle-callbacks.md (original)
+++ isis/site/trunk/content/reference/object-lifecycle-callbacks.md Tue May 5 19:51:18 2015
@@ -1,6 +1,8 @@
Object lifecycle callbacks
--------------------------
+[//]: # (content copied to _user-guide_xxx)
+
Isis supports a number of callback methods corresponding to the persistence lifecycle of the object.
They are:
Modified: isis/site/trunk/content/reference/recognized-annotations/Action.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Action.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Action.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Action.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Action
+[//]: # (content copied to _user-guide_xxx)
+
The `Action` annotation groups together all domain-specific metadata for an invokable action on a domain object or domain service:
* `domainEvent` - specifies the subtype of the `ActionDomainEvent` that should be posted to the [Event Bus service](../services/event-bus-service.htm) to broadcast the action's business rule checking (hide, disable, validate) and its invocation (pre-execute and post-execution).
Modified: isis/site/trunk/content/reference/recognized-annotations/ActionInteraction.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/ActionInteraction.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/ActionInteraction.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/ActionInteraction.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @ActionInteraction
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Action#domainEvent()](./Action.html).
The `@ActionInteraction` annotation applies to domain entity actions, allowing
Modified: isis/site/trunk/content/reference/recognized-annotations/ActionLayout.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/ActionLayout.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/ActionLayout.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/ActionLayout.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @ActionLayout (1.8.0)
+[//]: # (content copied to _user-guide_xxx)
+
The `@ActionLayout` annotation applies to actions, collecting together all UI hints within a single
annotation.
Modified: isis/site/trunk/content/reference/recognized-annotations/ActionOrder-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/ActionOrder-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/ActionOrder-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/ActionOrder-deprecated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @ActionOrder
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@MemberOrder#sequence()](./MemberOrder.html) or [dynamic layouts](../../components/viewers/wicket/dynamic-layouts.html).
`@ActionOrder` provides a mechanism to specify the order in which
Modified: isis/site/trunk/content/reference/recognized-annotations/ActionSemantics.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/ActionSemantics.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/ActionSemantics.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/ActionSemantics.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @ActionSemantics
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Action#semantics()](./Action.html).
This annotation, which applies only to actions, describes whether the
Modified: isis/site/trunk/content/reference/recognized-annotations/Aggregated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Aggregated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Aggregated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Aggregated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Aggregated
+[//]: # (content copied to _user-guide_xxx)
+
> This annotation has partial/incomplete support.
Modified: isis/site/trunk/content/reference/recognized-annotations/Audited.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Audited.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Audited.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Audited.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Audited
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@DomainObject#auditing()](./DomainObject.html).
This annotation, which applies only to objects, indicates that if the
Modified: isis/site/trunk/content/reference/recognized-annotations/AutoComplete.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/AutoComplete.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/AutoComplete.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/AutoComplete.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @AutoComplete
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@DomainObject#autoCompleteRepository](./DomainObject.html).
This annotation is to support an auto-complete capability for reference
Modified: isis/site/trunk/content/reference/recognized-annotations/Bookmarkable.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Bookmarkable.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Bookmarkable.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Bookmarkable.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Bookmarkable
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@DomainObject#bookmarking()](./DomainObject.html).
The `@Bookmarkable` annotation indicates that an entity or an action (with safe [action semantics](./ActionSemantics.html)) is automatically bookmarked.
Modified: isis/site/trunk/content/reference/recognized-annotations/Bounded.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Bounded.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Bounded.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Bounded.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Bounded
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@DomainObject#bounded()](./DomainObject.html).
For immutable objects where there is a bounded set of instances, the
Modified: isis/site/trunk/content/reference/recognized-annotations/Bulk.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Bulk.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Bulk.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Bulk.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Bulk
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Action#invokeOn()](./Action.html).
For actions that should only be applied to a collection of objects of
Modified: isis/site/trunk/content/reference/recognized-annotations/Collection.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Collection.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Collection.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Collection.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Collection (1.8.0)
+[//]: # (content copied to _user-guide_xxx)
+
> stub
The `@Collection` annotation applies to collections collecting together all domain semantics within a single annotation.
Modified: isis/site/trunk/content/reference/recognized-annotations/CollectionInteraction.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/CollectionInteraction.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/CollectionInteraction.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/CollectionInteraction.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @CollectionInteraction
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Collection#domainEvent()](./Collection.html).
> Support
Modified: isis/site/trunk/content/reference/recognized-annotations/CollectionLayout.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/CollectionLayout.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/CollectionLayout.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/CollectionLayout.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @CollectionLayout (1.8.0)
+[//]: # (content copied to _user-guide_xxx)
+
The `@CollectionLayout` annotation applies to collections, collecting together all UI hints within a single
annotation.
Modified: isis/site/trunk/content/reference/recognized-annotations/Command.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Command.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Command.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Command.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Command
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Action#command()](./Action.html).
The `@Command` annotation lets you change the way in which the framework invokes an action, most notably to invoke the action in the background. It works (and influences the behaviour of) the the `CommandContext`, `CommandService`, `BackgroundService` and `BackgroundCommandService` domain services (documented [here](../../../reference/services/command-context.html) and [here](../../../reference/services/background-service.html)).
Modified: isis/site/trunk/content/reference/recognized-annotations/CssClass-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/CssClass-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/CssClass-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/CssClass-deprecated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @CssClass
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@DomainObjectLayout#cssClass()](./DomainObjectLayout.html), [@PropertyLayout#cssClass()](./PropertyLayout.html), [@CollectionLayout#cssClass()](./CollectionLayout.html), [@ActionLayout#cssClass()](./ActionLayout.html) and [@ParameterLayout#cssClass()](./ParameterLayout.html), or use [dynamic layouts](../../components/viewers/wicket/dynamic-layouts.html).
The `CssClass` annotation applies to object and also to any object member
Modified: isis/site/trunk/content/reference/recognized-annotations/CssClassFa-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/CssClassFa-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/CssClassFa-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/CssClassFa-deprecated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @CssClassFa (1.8.0)
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@DomainObjectLayout#cssClassFa()](./DomainObjectLayout.html), [@PropertyLayout#cssClassFa()](./PropertyLayout.html), [@CollectionLayout#cssClassFa()](./CollectionLayout.html), [@ActionLayout#cssClassFa()](./ActionLayout.html) and [@ParameterLayout#cssClassFa()](./ParameterLayout.html), or use [dynamic layouts](../../components/viewers/wicket/dynamic-layouts.html).
The `CssClassFa` annotation applies to objects and also to object actions,
Modified: isis/site/trunk/content/reference/recognized-annotations/Debug-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Debug-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Debug-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Debug-deprecated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Debug
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Action#restrictTo()](./Action.html).
The `@Debug` annotation marks an action method as available in debug mode
Modified: isis/site/trunk/content/reference/recognized-annotations/Defaulted.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Defaulted.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Defaulted.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Defaulted.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Defaulted
+[//]: # (content copied to _user-guide_xxx)
+
> This annotation has partial/incomplete support.
The concept of "defaulted" means being able to provide a default value
Modified: isis/site/trunk/content/reference/recognized-annotations/DescribedAs-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/DescribedAs-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/DescribedAs-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/DescribedAs-deprecated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @DescribedAs
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@DomainObjectLayout#describedAs()](./DomainObjectLayout.html), [@PropertyLayout#describedAs()](./PropertyLayout.html), [@CollectionLayout#describedAs()](./CollectionLayout.html), [@ActionLayout#describedAs()](./ActionLayout.html) and [@ParameterLayout#describedAs()](./ParameterLayout.html), or use [dynamic layouts](../../components/viewers/wicket/dynamic-layouts.html).
The `@DescribedAs` annotation is used to provide a short description of
Modified: isis/site/trunk/content/reference/recognized-annotations/Digits.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Digits.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Digits.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Digits.md Tue May 5 19:51:18 2015
@@ -1,4 +1,6 @@
Title: @javax.validation.constraints.Digits
+[//]: # (content copied to _user-guide_xxx)
+
This is a stub.
Modified: isis/site/trunk/content/reference/recognized-annotations/Disabled.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Disabled.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Disabled.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Disabled.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Disabled
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Property#editing()](./Property.html), [@Collection#editing()](./Collection.html), and also [@DomainObject#editing()](./DomainObject.html)
> **Support**
Modified: isis/site/trunk/content/reference/recognized-annotations/DomainObject.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/DomainObject.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/DomainObject.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/DomainObject.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @DomainObject (1.8.0)
+[//]: # (content copied to _user-guide_xxx)
+
> stub
The `@DomainObject` annotation applies to domain objects, collecting together all domain semantics within a single annotation.
Modified: isis/site/trunk/content/reference/recognized-annotations/DomainObjectLayout.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/DomainObjectLayout.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/DomainObjectLayout.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/DomainObjectLayout.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @DomainObjectLayout (1.8.0)
+[//]: # (content copied to _user-guide_xxx)
+
The `@DomainObjectLayout` annotation applies to domain classes, collecting together all UI hints within a single
annotation.
Modified: isis/site/trunk/content/reference/recognized-annotations/DomainService.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/DomainService.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/DomainService.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/DomainService.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @DomainService
+[//]: # (content copied to _user-guide_xxx)
+
Indicates that the (concrete) class should be automatically instantiated as a domain service.
Domain services with this annotation do NOT need to be registered explicitly in `isis.properties`; they will be
Modified: isis/site/trunk/content/reference/recognized-annotations/DomainServiceLayout.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/DomainServiceLayout.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/DomainServiceLayout.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/DomainServiceLayout.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @DomainServiceLayout (1.8.0)
+[//]: # (content copied to _user-guide_xxx)
+
The `@DomainServiceLayout` annotation applies to domain services, collecting together all view layout semantics
within a single annotation.
Modified: isis/site/trunk/content/reference/recognized-annotations/Encodable.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Encodable.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Encodable.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Encodable.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Encodable
+[//]: # (content copied to _user-guide_xxx)
+
> This annotation has partial/incomplete support.
> In particular, the Wicket viewer uses Apache Wicket's Converter API instead.
Modified: isis/site/trunk/content/reference/recognized-annotations/EqualByContent.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/EqualByContent.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/EqualByContent.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/EqualByContent.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @EqualByContent
+[//]: # (content copied to _user-guide_xxx)
+
> This annotation has partial/incomplete support.
Equal-by-content is a characteristic of value types, and is implied by
Modified: isis/site/trunk/content/reference/recognized-annotations/Exploration-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Exploration-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Exploration-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Exploration-deprecated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Exploration
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Action#restrictTo()](./Action.html).
The `@Exploration` annotation marks an action method as available in
Modified: isis/site/trunk/content/reference/recognized-annotations/Facets.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Facets.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Facets.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Facets.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Facets
+[//]: # (content copied to _user-guide_xxx)
+
The `@Facets` annotation specifies `FacetFactory` implementations and so can
be used to run install arbitrary `Facet`s for a type. Generally this is
not needed, but can be useful for overriding a custom programming model
Modified: isis/site/trunk/content/reference/recognized-annotations/FieldOrder-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/FieldOrder-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/FieldOrder-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/FieldOrder-deprecated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @FieldOrder (deprecated)
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@MemberOrder#sequence()](./MemberOrder.html) or [dynamic layouts](../../components/viewers/wicket/dynamic-layouts.html).
`@FieldOrder` provides a mechanism to specify the order in which fields
Modified: isis/site/trunk/content/reference/recognized-annotations/Hidden-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Hidden-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Hidden-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Hidden-deprecated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Hidden
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated. For object members use [@PropertyLayout#hidden()](./PropertyLayout.html), [@CollectionLayout#hidden()](./CollectionLayout.html), and [@ActionLayout#hidden()](./ActionLayout.html). For domain servicesm use [@DomainService#nature()]
The `@Hidden` annotation indicates that the member (property, collection
Modified: isis/site/trunk/content/reference/recognized-annotations/HomePage.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/HomePage.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/HomePage.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/HomePage.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @HomePage
+[//]: # (content copied to _user-guide_xxx)
+
> Support
>
> Currently only by the Wicket viewer
Modified: isis/site/trunk/content/reference/recognized-annotations/Idempotent-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Idempotent-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Idempotent-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Idempotent-deprecated.md Tue May 5 19:51:18 2015
@@ -1,3 +1,5 @@
Title: @Idempotent (deprecated)
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Action#semantics()](./Action.html).
Modified: isis/site/trunk/content/reference/recognized-annotations/Ignore-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Ignore-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Ignore-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Ignore-deprecated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Ignore (deprecated)
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Action#semantics()](./Action.html).
Equivalent to using `@Programmatic`.
Modified: isis/site/trunk/content/reference/recognized-annotations/Immutable.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Immutable.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Immutable.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Immutable.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Immutable
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@DomainObject#editing()](./DomainObject.html).
The `@Immutable` annotation may be applied to a class, and indicates to
Modified: isis/site/trunk/content/reference/recognized-annotations/Inject.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Inject.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Inject.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Inject.md Tue May 5 19:51:18 2015
@@ -1,4 +1,6 @@
Title: @javax.inject.Inject
+[//]: # (content copied to _user-guide_xxx)
+
> this is a stub
Modified: isis/site/trunk/content/reference/recognized-annotations/Mask-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Mask-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Mask-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Mask-deprecated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Mask
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, never supported.
Modified: isis/site/trunk/content/reference/recognized-annotations/MaxLength.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/MaxLength.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/MaxLength.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/MaxLength.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @MaxLength
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Property#maxLength()](./Property.html) and [@Parameter#maxLength()](./Parameter.html) .
The `@MaxLength` annotation indicates the maximum number of characters
Modified: isis/site/trunk/content/reference/recognized-annotations/MemberGroupLayout.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/MemberGroupLayout.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/MemberGroupLayout.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/MemberGroupLayout.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @MemberGroupLayout
+[//]: # (content copied to _user-guide_xxx)
+
> See also [dynamic layouts](../../components/viewers/wicket/dynamic-layouts.html).
> **Support**
Modified: isis/site/trunk/content/reference/recognized-annotations/MemberGroups-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/MemberGroups-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/MemberGroups-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/MemberGroups-deprecated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @MemberGroups
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@MemberGroupLayout](./MemberGroupLayout.html) or [dynamic layouts](../../components/viewers/wicket/dynamic-layouts.html).
Modified: isis/site/trunk/content/reference/recognized-annotations/MemberOrder.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/MemberOrder.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/MemberOrder.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/MemberOrder.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @MemberOrder
+[//]: # (content copied to _user-guide_xxx)
+
> See also [dynamic layouts](../../components/viewers/wicket/dynamic-layouts.html).
`@MemberOrder` is the recommended mechanism for specifying the order in
Modified: isis/site/trunk/content/reference/recognized-annotations/MinLength.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/MinLength.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/MinLength.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/MinLength.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @MinLength
+[//]: # (content copied to _user-guide_xxx)
+
The `@MinLength` annotation is used to specify the minimum number of characters in a search of an [auto-complete](../../how-tos/how-to-03-025-How-to-specify-an-autocomplete-for-an-action-parameter.html).
For example:
Modified: isis/site/trunk/content/reference/recognized-annotations/MultiLine-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/MultiLine-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/MultiLine-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/MultiLine-deprecated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @MultiLine
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@PropertyLayout#multiLine()](./PropertyLayout.html) and [@ParameterLayout#multiLine()](./ParameterLayout.html) or [dynamic layouts](../../components/viewers/wicket/dynamic-layouts.html).
Modified: isis/site/trunk/content/reference/recognized-annotations/MustSatisfy.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/MustSatisfy.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/MustSatisfy.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/MustSatisfy.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @MustSatisfy
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Property#mustSatisfy()](./Property.html) and [@Parameter#mustSatisfy()](./Parameter.html).
The `@MustSatisfy` annotation allows validation to be applied to
Modified: isis/site/trunk/content/reference/recognized-annotations/Named-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Named-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Named-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Named-deprecated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Named
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@DomainObjectLayout#named()](./DomainObjectLayout.html), [@PropertyLayout#named()](./PropertyLayout.html), [@CollectionLayout#named()](./CollectionLayout.html), [@ActionLayout#named()](./ActionLayout.html) and [@ParameterLayout#named()](./ParameterLayout.html), or use [dynamic layouts](../../components/viewers/wicket/dynamic-layouts.html).
The `@Named` annotation is used when you want to specify the way
Modified: isis/site/trunk/content/reference/recognized-annotations/NotContributed.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/NotContributed.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/NotContributed.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/NotContributed.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @NotContributed
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@DomainService#nature()](./DomainService.html) to specify whether a service's actions are contributed, and use [@ActionLayout#contributed()](./ActionLayout.html) to specify how they are contributed.
The `@NotContributed` annotation applies only to action methods, and
Modified: isis/site/trunk/content/reference/recognized-annotations/NotInServiceMenu.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/NotInServiceMenu.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/NotInServiceMenu.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/NotInServiceMenu.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @NotInServiceMenu
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@DomainService#nature()](./DomainService.html) to specify whether a service's actions are visible on the menu bar.
The `@NotInServiceMenu` annotation applies only to action methods, and
Modified: isis/site/trunk/content/reference/recognized-annotations/NotPersistable.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/NotPersistable.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/NotPersistable.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/NotPersistable.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @NotPersistable
+[//]: # (content copied to _user-guide_xxx)
+
> This annotation has partial/incomplete support.
> In particular, it is not supported by: Wicket viewer. [ISIS-743](https://issues.apache.org/jira/browse/ISIS-743) has been raised contemplating the removal of this annotation.
Modified: isis/site/trunk/content/reference/recognized-annotations/NotPersisted.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/NotPersisted.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/NotPersisted.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/NotPersisted.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @NotPersisted
+[//]: # (content copied to _user-guide_xxx)
+
The `@NotPersisted` annotation indicates that the property is not to be
persisted.
Modified: isis/site/trunk/content/reference/recognized-annotations/ObjectType.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/ObjectType.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/ObjectType.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/ObjectType.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @ObjectType
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@DomainObject#objectType()](./DomainObject.html).
The `@ObjectType` annotation is used to provide a unique abbreviation for
Modified: isis/site/trunk/content/reference/recognized-annotations/Optional.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Optional.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Optional.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Optional.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Optional
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Property#optionality()](./Property.html) and [@Parameter#optionality()](./Parameter.html).
By default, the system assumes that all properties of an object are
Modified: isis/site/trunk/content/reference/recognized-annotations/Paged-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Paged-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Paged-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Paged-deprecated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Paged
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@CollectionLayout](./CollectionLayout.html) and [@DomainObjectLayout](./DomainObjectLayout.html).
This annotation is used to indicate that parented and/or standalone
Modified: isis/site/trunk/content/reference/recognized-annotations/Parameter.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Parameter.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Parameter.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Parameter.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Parameter (1.8.0)
+[//]: # (content copied to _user-guide_xxx)
+
> stub
Modified: isis/site/trunk/content/reference/recognized-annotations/ParameterLayout.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/ParameterLayout.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/ParameterLayout.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/ParameterLayout.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @ParameterLayout (1.8.0)
+[//]: # (content copied to _user-guide_xxx)
+
The `@ParameterLayout` annotation applies to action parameters, collecting together all UI hints within a single
annotation.
Modified: isis/site/trunk/content/reference/recognized-annotations/Parseable.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Parseable.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Parseable.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Parseable.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Parseable
+[//]: # (content copied to _user-guide_xxx)
+
> This annotation has partial/incomplete support.
> In particular, the Wicket viewer uses Apache Wicket's Converter API instead.
Modified: isis/site/trunk/content/reference/recognized-annotations/Plural-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Plural-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Plural-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Plural-deprecated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Plural
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@DomainObjectLayout#plural()](./DomainObjectLayout.html).
When the framework displays a collection of several objects it may use
Modified: isis/site/trunk/content/reference/recognized-annotations/PostsActionInvokedEvent-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/PostsActionInvokedEvent-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/PostsActionInvokedEvent-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/PostsActionInvokedEvent-deprecated.md Tue May 5 19:51:18 2015
@@ -1,3 +1,5 @@
Title: @PostsActionInvokedEvent
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Action#domainEvent()](./Action.html).
Modified: isis/site/trunk/content/reference/recognized-annotations/PostsCollectionAddedToEvent-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/PostsCollectionAddedToEvent-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/PostsCollectionAddedToEvent-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/PostsCollectionAddedToEvent-deprecated.md Tue May 5 19:51:18 2015
@@ -1,3 +1,5 @@
Title: @PostsCollectionAddedToEvent
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Collection#domainEvent()](./Collection.html).
Modified: isis/site/trunk/content/reference/recognized-annotations/PostsCollectionRemovedFromEvent-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/PostsCollectionRemovedFromEvent-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/PostsCollectionRemovedFromEvent-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/PostsCollectionRemovedFromEvent-deprecated.md Tue May 5 19:51:18 2015
@@ -1,3 +1,5 @@
Title: @PostsCollectionRemovedFromEvent
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Collection#domainEvent()](./Collection.html).
Modified: isis/site/trunk/content/reference/recognized-annotations/PostsPropertyChangedEvent-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/PostsPropertyChangedEvent-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/PostsPropertyChangedEvent-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/PostsPropertyChangedEvent-deprecated.md Tue May 5 19:51:18 2015
@@ -1,3 +1,5 @@
Title: @PostsPropertyChangedEvent
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Property#domainEvent()](./Property.html).
Modified: isis/site/trunk/content/reference/recognized-annotations/Programmatic.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Programmatic.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Programmatic.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Programmatic.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Programmatic
+[//]: # (content copied to _user-guide_xxx)
+
The `@Programmatic` annotation causes the method to be excluded completely from the Apache Isis metamodel. This means it won't appear in any UI, and it won't appear in any mementos/snapshots.
A common use-case is to ignore implementation-level artifacts. For
Modified: isis/site/trunk/content/reference/recognized-annotations/Property.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Property.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Property.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Property.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Property (1.8.0)
+[//]: # (content copied to _user-guide_xxx)
+
> stub
The `@Property` annotation applies to properties collecting together all domain semantics within a single annotation.
Modified: isis/site/trunk/content/reference/recognized-annotations/PropertyInteraction.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/PropertyInteraction.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/PropertyInteraction.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/PropertyInteraction.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @PropertyInteraction
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Property#domainEvent()](./Property.html).
The `@PropertyInteraction` annotation applies to domain entity properties, allowing
Modified: isis/site/trunk/content/reference/recognized-annotations/PropertyLayout.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/PropertyLayout.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/PropertyLayout.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/PropertyLayout.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @PropertyLayout (1.8.0)
+[//]: # (content copied to _user-guide_xxx)
+
The `@PropertyLayout` annotation applies to properties collecting together all UI hints within a single annotation:
* `cssClass` - the css class that a property should have, to allow more targetted styling in `application.css`
Modified: isis/site/trunk/content/reference/recognized-annotations/Prototype-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Prototype-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Prototype-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Prototype-deprecated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Prototype
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@ActionLayout#restrictTo()](./ActionLayout.html)
The `@Prototype` annotation marks an action method as available in
Modified: isis/site/trunk/content/reference/recognized-annotations/PublishedAction.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/PublishedAction.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/PublishedAction.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/PublishedAction.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @PublishedAction
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Action#publishing()](./Action.html).
This annotation on an action causes an events to be published by the registered implementation of a `PublishingService`.
Modified: isis/site/trunk/content/reference/recognized-annotations/PublishedObject.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/PublishedObject.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/PublishedObject.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/PublishedObject.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @PublishedObject
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@DomainObject#publishing()](./DomainObject.html).
This annotation on an entity type causes an events to be published by the registered implementation of a `PublishingService` if an instance of that type is inserted, updated or deleted .
Modified: isis/site/trunk/content/reference/recognized-annotations/QueryOnly-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/QueryOnly-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/QueryOnly-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/QueryOnly-deprecated.md Tue May 5 19:51:18 2015
@@ -1,4 +1,6 @@
Title: @QueryOnly (deprecated)
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Action#semantics()](./Action.html).
Modified: isis/site/trunk/content/reference/recognized-annotations/RegEx.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/RegEx.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/RegEx.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/RegEx.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @RegEx
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Property#regex()](./Property.html) and [@Parameter#regex()](./Parameter.html).
The `@RegEx` annotation may be applied to any string property, or to any
Modified: isis/site/trunk/content/reference/recognized-annotations/Render-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Render-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Render-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Render-deprecated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Render
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@CollectionLayout#render()](./CollectionLayout.html)
The `@Render` annotation is a hint for properties and collections to
Modified: isis/site/trunk/content/reference/recognized-annotations/RenderedAsDayBefore-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/RenderedAsDayBefore-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/RenderedAsDayBefore-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/RenderedAsDayBefore-deprecated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @RenderedAsDayBefore
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@PropertyLayout#renderedAsDayBefore()](./PropertyLayout.html) and [@ParameterLayout#renderedAsDayBefore()](./ParameterLayout.html) or [dynamic layouts](../../components/viewers/wicket/dynamic-layouts.html).
A rendering hint, instructing the viewer that the date should as one day prior to the actually stored date.
Modified: isis/site/trunk/content/reference/recognized-annotations/RequestScoped.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/RequestScoped.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/RequestScoped.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/RequestScoped.md Tue May 5 19:51:18 2015
@@ -1,3 +1,5 @@
Title: @javax.enterprise.context.RequestScoped
+[//]: # (content copied to _user-guide_xxx)
+
> this is a stub
Modified: isis/site/trunk/content/reference/recognized-annotations/Resolve-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Resolve-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Resolve-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Resolve-deprecated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Resolve (deprecated)
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@CollectionLayout#render()](./CollectionLayout.html)
Modified: isis/site/trunk/content/reference/recognized-annotations/SortedBy-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/SortedBy-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/SortedBy-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/SortedBy-deprecated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @SortedBy
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@CollectionLayout#sortedBy](./CollectionLayout.html).
The `@SortedBy` annotation is an instruction hint for (`SortedSet`) collections to use the specified comparator rather than the natural ordering of the entity
Modified: isis/site/trunk/content/reference/recognized-annotations/Title.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Title.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Title.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Title.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Title
+[//]: # (content copied to _user-guide_xxx)
+
The `@Title` annotation is used to indicate which property or properties
make up the object title. If more than one property is used, the order
can be specified (using the same Dewey-decimal notation as used by
Modified: isis/site/trunk/content/reference/recognized-annotations/TypeOf.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/TypeOf.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/TypeOf.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/TypeOf.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @TypeOf
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@Collection#typeOf](./Collection.html) or [@Action#typeOf](./Action.html).
The `@TypeOf` annotation is used to specify the type of elements in a
Modified: isis/site/trunk/content/reference/recognized-annotations/TypicalLength-deprecated.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/TypicalLength-deprecated.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/TypicalLength-deprecated.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/TypicalLength-deprecated.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @TypicalLength
+[//]: # (content copied to _user-guide_xxx)
+
> Deprecated, use instead [@PropertyLayout#typicalLength()](./PropertyLayout.html) and [@ParameterLayout#typicalLength()](./ParameterLayout.html) or [dynamic layouts](../../components/viewers/wicket/dynamic-layouts.html).
The `@TypicalLength` annotation indicates the typical length of a
Modified: isis/site/trunk/content/reference/recognized-annotations/Value.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Value.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/Value.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/Value.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @Value
+[//]: # (content copied to _user-guide_xxx)
+
> This annotation has partial/incomplete support.
The `@Value` annotation indicates that a class should be treated as a
Modified: isis/site/trunk/content/reference/recognized-annotations/ViewModel.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/ViewModel.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/ViewModel.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/ViewModel.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @ViewModel
+[//]: # (content copied to _user-guide_xxx)
+
The `@ViewModel` annotation, applied to a class, is the simplest way to indicate that the class is a view model.
View models are not persisted to the database, instead their state is encoded within their identity (ultimately
represented in the URL). As such, view models are immutable.
Modified: isis/site/trunk/content/reference/recognized-annotations/ViewModelLayout.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/ViewModelLayout.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/ViewModelLayout.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/ViewModelLayout.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: @ViewModelLayout (1.8.0)
+[//]: # (content copied to _user-guide_xxx)
+
> stub
The `@ViewModelLayout` annotation is identical to the [@DomainObjectLayout](./DomainObjectLayout.html), but is provided
Modified: isis/site/trunk/content/reference/services.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/services.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/services.md (original)
+++ isis/site/trunk/content/reference/services.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: Applib Services and Implementations
+[//]: # (content copied to _user-guide_xxx)
+
{domain-services
The services listed here are those whose API is defined in Isis applib. In addition the [Isis addons](http://www.isisaddons.org) website lists a number of services (such as [security](http://github.com/isisaddons/isis-module-security) service or the [settings](http://github.com/isisaddons/isis-module-settings) service that are standalone)
Modified: isis/site/trunk/content/reference/services/ClockService.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/services/ClockService.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/services/ClockService.md (original)
+++ isis/site/trunk/content/reference/services/ClockService.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
title: Clock Service
+[//]: # (content copied to _user-guide_xxx)
+
Most applications deal with dates and times in one way or another. For example, if an `Order` is placed, then the `Customer` may have 30 days to pay the Invoice, otherwise a penalty may be levied. However, this can complicate automated testing: "today+30" will be a different date every time the test is run.
Even disregarding testing, there may be a requirement to ensure that date/times are obtained from an NNTP server (rather than the system PC). While instantiating a `java.util.Date` to current the current time is painless enough, we would not want complex technical logic for querying an NNTP server spread around domain logic code.
Modified: isis/site/trunk/content/reference/services/auditing-service.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/services/auditing-service.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/services/auditing-service.md (original)
+++ isis/site/trunk/content/reference/services/auditing-service.md Tue May 5 19:51:18 2015
@@ -1,22 +1,24 @@
Title: Auditing Service
+[//]: # (content copied to _user-guide_xxx)
+
The auditing service provides a simple mechanism to capture changes to data. It is called for each property that has changed on any domain object, as a set of pre- and post-values.
## API
-
+
The API for the service is:
- public interface AuditingService3 {
-
- @Programmatic
- public void audit(
- final UUID transactionId, String targetClassName, final Bookmark target,
- String memberIdentifier, final String propertyName,
- final String preValue, final String postValue,
- final String user, final java.sql.Timestamp timestamp);
- }
+ public interface AuditingService3 {
+
+ @Programmatic
+ public void audit(
+ final UUID transactionId, String targetClassName, final Bookmark target,
+ String memberIdentifier, final String propertyName,
+ final String preValue, final String postValue,
+ final String user, final java.sql.Timestamp timestamp);
+ }
-> **BREAKING CHANGE!!!** The previous APIs for this service (`AuditingService` and `AuditingService2`) have been removed. The new API is a superset of these previous APIs. The change was made so that the auditing service would be consistent with the related [Publishing](./publishing-service.html) and the [Command Context](./command-context.html) services.
+> **BREAKING CHANGE!!!** The previous APIs for this service (`AuditingService` and `AuditingService2`) have been removed. The new API is a superset of these previous APIs. The change was made so that the auditing service would be consistent with the related [Publishing](./publishing-service.html) and the [Command Context](./command-context.html) services.
## API [1.3.0]
Modified: isis/site/trunk/content/reference/services/background-command-service.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/services/background-command-service.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/services/background-command-service.md (original)
+++ isis/site/trunk/content/reference/services/background-command-service.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: Background Command Service (isis-module-command-jdo)
+[//]: # (content copied to _user-guide_xxx)
+
The `BackgroundCommandService` supports the [BackgroundService](./background-service.html), persisting action invocations as commands such that they can subsequently be invoked in the background.
The `BackgroundService` is responsible for capturing a memento representing the action invocation, and then hands off to the `BackgroundCommandService` to actually persist it. The `isis-module-command-jdo` module provides an implementation of `BackgroundCommandService` ([BackgroundCommandServiceJdo](../../components/objectstores/jdo/services/background-command-service-jdo.html)) that persists to an RBMS entities.
Modified: isis/site/trunk/content/reference/services/background-service.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/services/background-service.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/services/background-service.md (original)
+++ isis/site/trunk/content/reference/services/background-service.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: Background Service
+[//]: # (content copied to _user-guide_xxx)
+
The `BackgroundService`, and its companion `BackgroundCommandService`, enable action invocations to be persisted such that they may be invoked in the background.
The `BackgroundService` is responsible for capturing a memento representing the action invocation, and persisting it. The default `BackgroundServiceDefault` implementation (provided by isis-core) uses (a private copy of) [MementoService](./memento-service.html), and then delegates the persistence of the memento to an appropriate implementation of the companion `BackgroundCommandService`. One such implementation is `isis-module-command-jdo`'s [BackgroundCommandServiceJdo](./background-command-service.html).
Modified: isis/site/trunk/content/reference/services/bookmark-service.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/services/bookmark-service.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/services/bookmark-service.md (original)
+++ isis/site/trunk/content/reference/services/bookmark-service.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: Bookmark Service
+[//]: # (content copied to _user-guide_xxx)
+
The `BookmarkService` provides the ability to obtain a serializable `org.apache.isis.applib.bookmarks.Bookmark` for any (persisted) domain object, and to lookup domain objects given a `Bookmark`.
This is a good way of storing a reference to an arbitrary object (a polymorphic relationship). The downside is that there is no way for the objectstore (eg JDO objectstore) to enforce any kind of referental integrity.
Modified: isis/site/trunk/content/reference/services/bulk-interaction.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/services/bulk-interaction.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/services/bulk-interaction.md (original)
+++ isis/site/trunk/content/reference/services/bulk-interaction.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: Bulk Interaction
+[//]: # (content copied to _user-guide_xxx)
+
The `Bulk.InteractionContext` domain service is a [request-scoped](../../more-advanced-topics/how-to-09-020-How-to-write-a-typical-domain-service.html) service intended to support the implementation of [@Bulk](../recognized-annotations/Bulk.html) actions. That is, when a bulk action is invoked over a collection of objects, each object instance "knows where it is" in the collection. In essence, the `Bulk.InteractionContext` service acts a little like an iterator.
### API
Modified: isis/site/trunk/content/reference/services/command-context.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/services/command-context.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/services/command-context.md (original)
+++ isis/site/trunk/content/reference/services/command-context.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: CommandContext
+[//]: # (content copied to _user-guide_xxx)
+
The `CommandContext` service is a [request-scoped](../../more-advanced-topics/how-to-09-020-How-to-write-a-typical-domain-service.html) service that reifies the invocation of an action on a domain object into an object itself. This reified information is encapsulated within the `Command` object.
By default, the `Command` is held in-memory only; once the action invocation has completed, the `Command` object is gone. The optional
Modified: isis/site/trunk/content/reference/services/command-service.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/services/command-service.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/services/command-service.md (original)
+++ isis/site/trunk/content/reference/services/command-service.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: CommandService (isis-module-command-jdo)
+[//]: # (content copied to _user-guide_xxx)
+
The `CommandService` service supports the [CommandContext](./command-context.html) service such that `Command` objects (that reify the invocation of an action on a domain object into an object) can be persisted.
Persistent `Command`s support several use cases:
Modified: isis/site/trunk/content/reference/services/deep-link-service.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/services/deep-link-service.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/services/deep-link-service.md (original)
+++ isis/site/trunk/content/reference/services/deep-link-service.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: Deep Link Service (1.8.0)
+[//]: # (content copied to _user-guide_xxx)
+
The `DeepLinkService` provides the ability to obtain a `java.net.URI` that links to a representation of any (persisted) domain entity or
view model.
Modified: isis/site/trunk/content/reference/services/developer-utilities-service.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/services/developer-utilities-service.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/services/developer-utilities-service.md (original)
+++ isis/site/trunk/content/reference/services/developer-utilities-service.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: Developer Utilities Service
+[//]: # (content copied to _user-guide_xxx)
+
{note
In 1.6.0 this implementation was released as part of *org.apache.isis.core:isis-module-devutils-jdo:1.6.0* and was also released as an [Isis addon](http://github.com/isisaddons/isis-module-devutils) module. **In 1.7.0+ only the [Isis addon](http://github.com/isisaddons/isis-module-devutils) implementation is released.**
}
Modified: isis/site/trunk/content/reference/services/email-notification-service.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/services/email-notification-service.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/services/email-notification-service.md (original)
+++ isis/site/trunk/content/reference/services/email-notification-service.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: Email Notification Service (1.8.0)
+[//]: # (content copied to _user-guide_xxx)
+
The email notification service supports the user registration process whereby a user can sign-up to access an application by providing a valid email address. The Wicket viewer will check whether an implementation of this service (and also the [user registration service](./user-registration-service.html)) is available, and if so will (unless configured not to) expose a sign-up page where the user enters their email address. A verification email is sent using this service; the email includes a link back to the running application. The user then completes the registration process (choosing a user name, password and so on) and the Wicket viewer creates an account for them (using the aforementioned [user registration service](./user-registration-service.html)).
The framework provides both an API and a default implementation of this service. The implementation depends in turn on the [email service](./email-service.html).
Modified: isis/site/trunk/content/reference/services/email-service.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/services/email-service.md?rev=1677885&r1=1677884&r2=1677885&view=diff
==============================================================================
--- isis/site/trunk/content/reference/services/email-service.md (original)
+++ isis/site/trunk/content/reference/services/email-service.md Tue May 5 19:51:18 2015
@@ -1,5 +1,7 @@
Title: Email Service (1.8.0)
+[//]: # (content copied to _user-guide_xxx)
+
The email service provides the ability to send emails to one or more recipients. The framework also provides a default implementation that sends email as an HTML message, using an external SMTP provider.
## API