http://git-wip-us.apache.org/repos/asf/isis-site/blob/6ad91949/content/guides/rgant/rgant.html
----------------------------------------------------------------------
diff --git a/content/guides/rgant/rgant.html b/content/guides/rgant/rgant.html
index c757d5e..44fca97 100644
--- a/content/guides/rgant/rgant.html
+++ b/content/guides/rgant/rgant.html
@@ -472,7 +472,7 @@
             <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td> 
             <td class="content"> 
              <div class="paragraph"> 
-              <p>Most UI semantics can also be specified using <a 
href="ugfun.html#_ugfun_object-layout_dynamic">dynamic object layout</a>.</p> 
+              <p>Most UI semantics can also be specified using <a 
href="../ugvw/ugvw.html#_ugvw_layout_file-based">dynamic object layout</a>.</p> 
              </div> </td> 
            </tr> 
           </tbody>
@@ -496,12 +496,12 @@
            <th class="tableblock halign-left valign-top">Annotation</th> 
            <th class="tableblock halign-left valign-top">Purpose</th> 
            <th class="tableblock halign-left valign-top">Layer</th> 
-           <th class="tableblock halign-left valign-top"><a 
href="ugfun.html#_ugfun_object-layout_dynamic">Dynamic layout</a>?</th> 
+           <th class="tableblock halign-left valign-top"><a 
href="../ugvw/ugvw.html#_ugvw_layout_file-based">File-based layout</a>?</th> 
           </tr> 
          </thead> 
          <tbody> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a href="#_rgant-Action"><code>@Action</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-Action"><code>@Action</code></a></p></td> 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -512,7 +512,7 @@
            <td class="tableblock halign-left valign-top"></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-ActionLayout"><code>@ActionLayout</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-ActionLayout"><code>@ActionLayout</code></a></p></td>
 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -523,7 +523,7 @@
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Yes</p></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-Collection"><code>@Collection</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-Collection"><code>@Collection</code></a></p></td>
 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -534,7 +534,7 @@
            <td class="tableblock halign-left valign-top"></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-CollectionLayout"><code>@CollectionLayout</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-CollectionLayout"><code>@CollectionLayout</code></a></p></td>
 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -545,7 +545,7 @@
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Yes</p></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-DomainObject"><code>@DomainObject</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-DomainObject"><code>@DomainObject</code></a></p></td>
 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -556,7 +556,7 @@
            <td class="tableblock halign-left valign-top"></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-DomainObjectLayout"><code>@DomainObjectLayout</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-DomainObjectLayout"><code>@DomainObjectLayout</code></a></p></td>
 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -567,7 +567,7 @@
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Yes</p></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-DomainService"><code>@DomainService</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-DomainService"><code>@DomainService</code></a></p></td>
 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -578,7 +578,7 @@
            <td class="tableblock halign-left valign-top"></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-DomainServiceLayout"><code>@DomainServiceLayout</code></a></p></td>
 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-DomainServiceLayout"><code>@DomainServiceLayout</code></a></p></td>
 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -589,7 +589,7 @@
            <td class="tableblock halign-left valign-top"></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-Parameter"><code>@Parameter</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-Parameter"><code>@Parameter</code></a></p></td>
 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -600,7 +600,7 @@
            <td class="tableblock halign-left valign-top"></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-ParameterLayout"><code>@ParameterLayout</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-ParameterLayout"><code>@ParameterLayout</code></a></p></td>
 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -611,7 +611,7 @@
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Yes</p></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-Property"><code>@Property</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-Property"><code>@Property</code></a></p></td> 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -622,7 +622,7 @@
            <td class="tableblock halign-left valign-top"></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-PropertyLayout"><code>@PropertyLayout</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-PropertyLayout"><code>@PropertyLayout</code></a></p></td>
 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -633,7 +633,7 @@
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Yes</p></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-ViewModel"><code>@ViewModel</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-ViewModel"><code>@ViewModel</code></a></p></td>
 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -644,7 +644,7 @@
            <td class="tableblock halign-left valign-top"></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-ViewModelLayout"><code>@ViewModelLayout</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-ViewModelLayout"><code>@ViewModelLayout</code></a></p></td>
 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -678,12 +678,12 @@
            <th class="tableblock halign-left valign-top">Annotation</th> 
            <th class="tableblock halign-left valign-top">Purpose</th> 
            <th class="tableblock halign-left valign-top">Layer</th> 
-           <th class="tableblock halign-left valign-top"><a 
href="ugfun.html#_ugfun_object-layout_dynamic">Dynamic layout</a>?</th> 
+           <th class="tableblock halign-left valign-top"><a 
href="../ugvw/ugvw.html#_ugvw_layout_file-based">File-based layout</a>?</th> 
           </tr> 
          </thead> 
          <tbody> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a href="#_rgant-Facets"><code>@Facets</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-Facets"><code>@Facets</code></a></p></td> 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -694,7 +694,7 @@
            <td class="tableblock halign-left valign-top"></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-HomePage"><code>@HomePage</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-HomePage"><code>@HomePage</code></a></p></td> 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -705,7 +705,7 @@
            <td class="tableblock halign-left valign-top"></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-MemberOrder"><code>@MemberOrder</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-MemberOrder"><code>@MemberOrder</code></a></p></td>
 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -716,7 +716,7 @@
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Yes</p></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-MinLength"><code>@MinLength</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-MinLength"><code>@MinLength</code></a></p></td>
 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -727,7 +727,7 @@
            <td class="tableblock halign-left valign-top"></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-Programmatic"><code>@Programmatic</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-Programmatic"><code>@Programmatic</code></a></p></td>
 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -785,7 +785,7 @@
          </thead> 
          <tbody> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-Column"><code>@javax.jdo.annotations.</code><br> 
<code>Column</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-Column"><code>@javax.jdo.annotations.</code><br>
 <code>Column</code></a></p></td> 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -796,46 +796,46 @@
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Property</p></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-Discriminator"><code>@javax.jdo.annotations.</code><br> 
<code>Discriminator</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-Discriminator"><code>@javax.jdo.annotations.</code><br>
 <code>Discriminator</code></a></p></td> 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p>Override for the object type, as used in `Bookmark`s, URLs 
for <a href="ugvro.html">RestfulObjects viewer</a> and elsewhere.<br></p> 
+              <p>Override for the object type, as used in `Bookmark`s, URLs 
for <a href="../ugvro/ugvro.html">RestfulObjects viewer</a> and 
elsewhere.<br></p> 
              </div> 
              <div class="paragraph"> 
-              <p>Note that the discriminator overrides the object type that 
may otherwise be inferred from the <a 
href="#_rgant-PersistenceCapable"><code>@PersistenceCapable</code></a> 
annotation.</p> 
+              <p>Note that the discriminator overrides the object type that 
may otherwise be inferred from the <a 
href="../rgant/rgant.html#_rgant-PersistenceCapable"><code>@PersistenceCapable</code></a>
 annotation.</p> 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain / persistence</p></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Class</p></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-NotPersistent"><code>@javax.jdo.annotations.</code><br> 
<code>NotPersistent</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-NotPersistent"><code>@javax.jdo.annotations.</code><br>
 <code>NotPersistent</code></a></p></td> 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p>Used to determine whether to enforce or skip some <a 
href="ugbtb.html#_ugbtb_programming-model_custom-validator">metamodel 
validation</a> for <code>@Column</code> versus equivalent Isis annotations.</p> 
+              <p>Used to determine whether to enforce or skip some <a 
href="../ugbtb/ugbtb.html#_ugbtb_programming-model_custom-validator">metamodel 
validation</a> for <code>@Column</code> versus equivalent Isis annotations.</p> 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain / persistence</p></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Property</p></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-PersistenceCapable"><code>@javax.jdo.annotations.</code><br> 
<code>PersistenceCapable</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-PersistenceCapable"><code>@javax.jdo.annotations.</code><br>
 <code>PersistenceCapable</code></a></p></td> 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
               <p>Used to build Apache Isis' own internal identifier for 
objects.<br></p> 
              </div> 
              <div class="paragraph"> 
-              <p>If the <code>schema()</code> attribute is specified (and if 
<a href="#<em>rgant-Discriminator"><code>@Discriminator</code></a> _hasn’t 
been specified), is also used to derive the object type, as used in 
`Bookmark`s, URLs for <a href="ugvro.html">RestfulObjects viewer</a> and 
elsewhere.</p> 
+              <p>If the <code>schema()</code> attribute is specified (and if 
<a 
href="../rgant/rgant.html#<em>rgant-Discriminator"><code>@Discriminator</code></a>
 _hasn’t been specified), is also used to derive the object type, as used in 
`Bookmark`s, URLs for <a href="../ugvro/ugvro.html">RestfulObjects viewer</a> 
and elsewhere.</p> 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain / persistence</p></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Class</p></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-PrimaryKey"><code>@javax.jdo.annotations.</code><br> 
<code>PrimaryKey</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-PrimaryKey"><code>@javax.jdo.annotations.</code><br>
 <code>PrimaryKey</code></a></p></td> 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -929,12 +929,12 @@
            <th class="tableblock halign-left valign-top">Annotation</th> 
            <th class="tableblock halign-left valign-top">Purpose</th> 
            <th class="tableblock halign-left valign-top">Layer</th> 
-           <th class="tableblock halign-left valign-top"><a 
href="ugfun.html#_ugfun_object-layout_dynamic">Dynamic layout</a>?</th> 
+           <th class="tableblock halign-left valign-top"><a 
href="../ugvw/ugvw.html#_ugvw_layout_file-based">File-based layout</a>?</th> 
           </tr> 
          </thead> 
          <tbody> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a href="#_rgant-Digits"><code>@javax.validation.</code><br> 
<code>constraints.</code><br> <code>Digits</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-Digits"><code>@javax.validation.</code><br> 
<code>constraints.</code><br> <code>Digits</code></a></p></td> 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -945,7 +945,7 @@
            <td class="tableblock halign-left valign-top"></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a href="#_rgant-Inject"><code>@javax.inject.</code><br> 
<code>Inject</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-Inject"><code>@javax.inject.</code><br> 
<code>Inject</code></a></p></td> 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -956,7 +956,7 @@
            <td class="tableblock halign-left valign-top"></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a href="#_rgant-Digits"><code>@javax.annotation.</code><br> 
<code>Nullable</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-Digits"><code>@javax.annotation.</code><br> 
<code>Nullable</code></a></p></td> 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -967,29 +967,29 @@
            <td class="tableblock halign-left valign-top"></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-PostConstruct"><code>@javax.annotation.</code><br> 
<code>PostConstruct</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-PostConstruct"><code>@javax.annotation.</code><br>
 <code>PostConstruct</code></a></p></td> 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p>Callback for domain services (either singleton or <a 
href="#_rgant-RequestScoped">request-scoped</a>) to initialize themselves once 
instantiated.</p> 
+              <p>Callback for domain services (either singleton or <a 
href="../rgant/rgant.html#_rgant-RequestScoped">request-scoped</a>) to 
initialize themselves once instantiated.</p> 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
            <td class="tableblock halign-left valign-top"></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-PreDestroy"><code>@javax.annotation.</code><br> 
<code>PreDestroy</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-PreDestroy"><code>@javax.annotation.</code><br>
 <code>PreDestroy</code></a></p></td> 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p>Callback for domain services (either singleton or <a 
href="#_rgant-RequestScoped">request-scoped</a>) to clean up resources prior to 
destruction.</p> 
+              <p>Callback for domain services (either singleton or <a 
href="../rgant/rgant.html#_rgant-RequestScoped">request-scoped</a>) to clean up 
resources prior to destruction.</p> 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
            <td class="tableblock halign-left valign-top"></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-RequestScoped"><code>@javax.enterprise.</code><br> 
<code>context.</code><br> <code>RequestScoped</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-RequestScoped"><code>@javax.enterprise.</code><br>
 <code>context.</code><br> <code>RequestScoped</code></a></p></td> 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -1000,7 +1000,7 @@
            <td class="tableblock halign-left valign-top"></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-XmlRootElement"><code>javax.xml.bind</code><br> 
<code>.annotation</code><br> <code>XmlRootElement</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-XmlRootElement"><code>javax.xml.bind</code><br>
 <code>.annotation</code><br> <code>XmlRootElement</code></a></p></td> 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
@@ -1011,11 +1011,11 @@
            <td class="tableblock halign-left valign-top"></td> 
           </tr> 
           <tr> 
-           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-XmlJavaTypeAdapter"><code>javax.xml.bind</code><br> 
<code>.annotation</code><br> <code>XmlJavaTypeAdapter</code></a></p></td> 
+           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-XmlJavaTypeAdapter"><code>javax.xml.bind</code><br>
 <code>.annotation</code><br> <code>XmlJavaTypeAdapter</code></a></p></td> 
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p>JAXB annotation defining how to serialize an entity. Used in 
conjunction with the (framework provided) <code>PersistentEntityAdapter</code> 
class to serialize persistent entities into a canonical OID (equivalent to the 
<code>Bookmark</code> provided by the <a 
href="rgsvc.html#_rgsvc_api_BookmarkService"><code>BookmarkService</code></a>).</p>
 
+              <p>JAXB annotation defining how to serialize an entity. Used in 
conjunction with the (framework provided) <code>PersistentEntityAdapter</code> 
class to serialize persistent entities into a canonical OID (equivalent to the 
<code>Bookmark</code> provided by the <a 
href="../rgsvc/rgsvc.html#_rgsvc_api_BookmarkService"><code>BookmarkService</code></a>).</p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1031,7 +1031,7 @@
          <p>As Apache Isis has evolved and grown, we found ourselves adding 
more and more annotations; but most of these related to either an object type 
(entity, view model, service) or an object member (property, collection, 
action). Over time it became harder and harder for end programmers to discover 
these new features.</p> 
         </div> 
         <div class="paragraph"> 
-         <p>Accordingly, (in v1.8.0) we decided to unify the semantics into 
the main (core) annotations listed <a href="#_rgant-aaa_main">above</a>.</p> 
+         <p>Accordingly, (in v1.8.0) we decided to unify the semantics into 
the main (core) annotations listed <a 
href="../rgant/rgant.html#_rgant-aaa_main">above</a>.</p> 
         </div> 
         <div class="paragraph"> 
          <p>The annotations listed in the table below are still supported by 
Apache Isis, but will be retired in Apache Isis v2.0.</p> 
@@ -1053,7 +1053,7 @@
            <th class="tableblock halign-left valign-top">Purpose</th> 
            <th class="tableblock halign-left valign-top">Use instead</th> 
            <th class="tableblock halign-left valign-top">Layer</th> 
-           <th class="tableblock halign-left valign-top"><a 
href="ugfun.html#_ugfun_object-layout_dynamic">Dynamic layout</a>?</th> 
+           <th class="tableblock halign-left valign-top"><a 
href="../ugvw/ugvw.html#_ugvw_layout_file-based">File-based layout</a>?</th> 
           </tr> 
          </thead> 
          <tbody> 
@@ -1068,7 +1068,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-MemberOrder"><code>@MemberOrder</code></a></p> 
+              <p><a 
href="../rgant/rgant.html#_rgant-MemberOrder"><code>@MemberOrder</code></a></p> 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -1085,7 +1085,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-Action_domainEvent"><code>@Action#domainEvent()</code></a></p> 
+              <p><a 
href="../rgant/rgant.html#_rgant-Action_domainEvent"><code>@Action#domainEvent()</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1102,7 +1102,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-Action_semantics"><code>@Action#semantics()</code></a></p> 
+              <p><a 
href="../rgant/rgant.html#_rgant-Action_semantics"><code>@Action#semantics()</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1119,7 +1119,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-DomainObject_auditing"><code>@DomainObject#</code><br> 
<code>auditing()</code></a></p> 
+              <p><a 
href="../rgant/rgant.html#_rgant-DomainObject_auditing"><code>@DomainObject#</code><br>
 <code>auditing()</code></a></p> 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1136,7 +1136,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-DomainObject_autoCompleteRepository"><code>@DomainObject</code><br>
 <code>#autoCompleteRepository()</code></a></p> 
+              <p><a 
href="../rgant/rgant.html#_rgant-DomainObject_autoCompleteRepository"><code>@DomainObject</code><br>
 <code>#autoCompleteRepository()</code></a></p> 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI/Domain</p></td> 
@@ -1153,7 +1153,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-DomainObjectLayout_bookmarking"><code>@DomainObjectLayout</code><br>
 <code>#bookmarking()</code></a></p> 
+              <p><a 
href="../rgant/rgant.html#_rgant-DomainObjectLayout_bookmarking"><code>@DomainObjectLayout</code><br>
 <code>#bookmarking()</code></a></p> 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -1170,7 +1170,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-DomainObject_bounded"><code>@DomainObject#bounded()</code></a></p>
 
+              <p><a 
href="../rgant/rgant.html#_rgant-DomainObject_bounded"><code>@DomainObject#bounded()</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1187,7 +1187,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-Action_invokeOn"><code>@Action#invokeOn()</code></a></p> 
+              <p><a 
href="../rgant/rgant.html#_rgant-Action_invokeOn"><code>@Action#invokeOn()</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI, Domain</p></td> 
@@ -1204,7 +1204,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-Collection_domainEvent"><code>@Collection#domainEvent()</code></a></p>
 
+              <p><a 
href="../rgant/rgant.html#_rgant-Collection_domainEvent"><code>@Collection#domainEvent()</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1221,7 +1221,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-Action_command"><code>@Action#command()</code></a></p> 
+              <p><a 
href="../rgant/rgant.html#_rgant-Action_command"><code>@Action#command()</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1238,7 +1238,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><code>#cssClass()</code> attribute for: <a 
href="#_rgant-DomainObjectLayout_cssClass"><code>@DomainObjectLayout</code></a>,
 <a href="#_rgant-PropertyLayout_cssClass"><code>@PropertyLayout</code></a>, <a 
href="#_rgant-CollectionLayout_cssClass"><code>@CollectionLayout</code></a>, <a 
href="#_rgant-ActionLayout_cssClass"><code>@ActionLayout</code></a> and <a 
href="#_rgant-ParameterLayout_cssClass"><code>@ParameterLayout</code></a></p> 
+              <p><code>#cssClass()</code> attribute for: <a 
href="../rgant/rgant.html#_rgant-DomainObjectLayout_cssClass"><code>@DomainObjectLayout</code></a>,
 <a 
href="../rgant/rgant.html#_rgant-PropertyLayout_cssClass"><code>@PropertyLayout</code></a>,
 <a 
href="../rgant/rgant.html#_rgant-CollectionLayout_cssClass"><code>@CollectionLayout</code></a>,
 <a 
href="../rgant/rgant.html#_rgant-ActionLayout_cssClass"><code>@ActionLayout</code></a>
 and <a 
href="../rgant/rgant.html#_rgant-ParameterLayout_cssClass"><code>@ParameterLayout</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -1255,7 +1255,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><code>cssClassFa()</code> attribute for: <a 
href="#_rgant-ActionLayout_cssClassFa"><code>@ActionLayout</code></a>, <a 
href="#_rgant-DomainObjectLayout_cssClassFa"><code>DomainObjectLayout</code></a>
 and <a 
href="#_rgant-ViewModelLayout_cssClassFa"><code>ViewModelLayout</code></a></p> 
+              <p><code>cssClassFa()</code> attribute for: <a 
href="../rgant/rgant.html#_rgant-ActionLayout_cssClassFa"><code>@ActionLayout</code></a>,
 <a 
href="../rgant/rgant.html#_rgant-DomainObjectLayout_cssClassFa"><code>DomainObjectLayout</code></a>
 and <a 
href="../rgant/rgant.html#_rgant-ViewModelLayout_cssClassFa"><code>ViewModelLayout</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -1272,7 +1272,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p>Not supported by either the <a href="ugvw.html">Wicket 
viewer</a> or the <a href="ugvro.html">RestfulObjects viewer</a>; use prototype 
mode instead (<a 
href="#_rgant-Action_restrictTo"><code>@Action#restrictTo()</code></a>)</p> 
+              <p>Not supported by either the <a 
href="../ugvw/ugvw.html">Wicket viewer</a> or the <a 
href="../ugvro/ugvro.html">RestfulObjects viewer</a>; use prototype mode 
instead (<a 
href="../rgant/rgant.html#_rgant-Action_restrictTo"><code>@Action#restrictTo()</code></a>)</p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -1289,7 +1289,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><code>#describedAs()</code> attribute for <a 
href="#_rgant-DomainObject_describedAs"><code>@DomainObjectLayout</code></a>, 
<a href="#_rgant-PropertyLayout_describedAs"><code>@PropertyLayout</code></a>, 
<a 
href="#_rgant-CollectionLayout_describedAs"><code>@CollectionLayout</code></a>, 
<a href="#_rgant-ActionLayout_describedAs"><code>@ActionLayout</code></a> and 
<a 
href="#_rgant-ParameterLayout_describedAs"><code>@ParameterLayout</code></a></p>
 
+              <p><code>#describedAs()</code> attribute for <a 
href="../rgant/rgant.html#_rgant-DomainObject_describedAs"><code>@DomainObjectLayout</code></a>,
 <a 
href="../rgant/rgant.html#_rgant-PropertyLayout_describedAs"><code>@PropertyLayout</code></a>,
 <a 
href="../rgant/rgant.html#_rgant-CollectionLayout_describedAs"><code>@CollectionLayout</code></a>,
 <a 
href="../rgant/rgant.html#_rgant-ActionLayout_describedAs"><code>@ActionLayout</code></a>
 and <a 
href="../rgant/rgant.html#_rgant-ParameterLayout_describedAs"><code>@ParameterLayout</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -1306,7 +1306,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><code>#editing()</code> attribute for <a 
href="#_rgant-Property_editing"><code>@Property</code></a>, <a 
href="#_rgant-Collection_editing"><code>@Collection</code></a> and <a 
href="#_rgant-DomainObject_editing"><code>@DomainObject</code></a></p> 
+              <p><code>#editing()</code> attribute for <a 
href="../rgant/rgant.html#_rgant-Property_editing"><code>@Property</code></a>, 
<a 
href="../rgant/rgant.html#_rgant-Collection_editing"><code>@Collection</code></a>
 and <a 
href="../rgant/rgant.html#_rgant-DomainObject_editing"><code>@DomainObject</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI, Domain</p></td> 
@@ -1323,7 +1323,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p>Not supported by either the <a href="ugvw.html">Wicket 
viewer</a> or the <a href="ugvro.html">RestfulObjects viewer</a>; use prototype 
mode instead (<a 
href="#_rgant-Action_restrictTo"><code>@Action#restrictTo()</code></a>)</p> 
+              <p>Not supported by either the <a 
href="../ugvw/ugvw.html">Wicket viewer</a> or the <a 
href="../ugvro/ugvro.html">RestfulObjects viewer</a>; use prototype mode 
instead (<a 
href="../rgant/rgant.html#_rgant-Action_restrictTo"><code>@Action#restrictTo()</code></a>)</p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -1340,7 +1340,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-MemberOrder"><code>@MemberOrder</code></a></p> 
+              <p><a 
href="../rgant/rgant.html#_rgant-MemberOrder"><code>@MemberOrder</code></a></p> 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -1357,7 +1357,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p>For domain object members, use <code>#hidden()</code> 
attribute of <a href="#_rgant-Action_hidden"><code>Action</code></a>, <a 
href="#_rgant-Property_hidden"><code>Property</code></a> or <a 
href="#_rgant-Collection_hidden"><code>Collection</code></a>. <br> For domain 
service, use <a 
href="#_rgant-DomainService_nature"><code>@DomainService(</code><br> 
<code>nature=DOMAIN)</code></a></p> 
+              <p>For domain object members, use <code>#hidden()</code> 
attribute of <a 
href="../rgant/rgant.html#_rgant-Action_hidden"><code>Action</code></a>, <a 
href="../rgant/rgant.html#_rgant-Property_hidden"><code>Property</code></a> or 
<a 
href="../rgant/rgant.html#_rgant-Collection_hidden"><code>Collection</code></a>.
 <br> For domain service, use <a 
href="../rgant/rgant.html#_rgant-DomainService_nature"><code>@DomainService(</code><br>
 <code>nature=DOMAIN)</code></a></p> 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI, Domain</p></td> 
@@ -1374,7 +1374,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-Action_semantics"><code>@Action#semantics</code></a></p> 
+              <p><a 
href="../rgant/rgant.html#_rgant-Action_semantics"><code>@Action#semantics</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1391,7 +1391,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-Programmatic"><code>@Programmatic</code></a>.<br></p> 
+              <p><a 
href="../rgant/rgant.html#_rgant-Programmatic"><code>@Programmatic</code></a>.<br></p>
 
              </div> 
              <div class="paragraph"> 
               <p><code>@Ignore</code> was deprecated because it can easily 
clash with <code>@org.junit.Ignore</code>.</p> 
@@ -1411,7 +1411,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-DomainObject_editing"><code>@DomainObject#editing()</code></a></p>
 
+              <p><a 
href="../rgant/rgant.html#_rgant-DomainObject_editing"><code>@DomainObject#editing()</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1445,7 +1445,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><code>#maxLength()</code> attribute for <a 
href="#_rgant-Property_maxLength"><code>@Property</code></a> or <a 
href="#_rgant-Parameter_maxLength"><code>@Parameter</code></a></p> 
+              <p><code>#maxLength()</code> attribute for <a 
href="../rgant/rgant.html#_rgant-Property_maxLength"><code>@Property</code></a> 
or <a 
href="../rgant/rgant.html#_rgant-Parameter_maxLength"><code>@Parameter</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1462,7 +1462,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a href="ugfun.html#_ugfun_object-layout_dynamic_xml">dynamic 
<code>.layout.xml</code></a> files</p> 
+              <p><a href="../ugvw/ugvw.html#_ugvw_layout_file-based">dynamic 
<code>.layout.xml</code></a> files</p> 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -1479,7 +1479,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a href="ugfun.html#_ugfun_object-layout_dynamic_xml">dynamic 
<code>.layout.xml</code></a> files</p> 
+              <p><a href="../ugvw/ugvw.html#_ugvw_layout_file-based">dynamic 
<code>.layout.xml</code></a> files</p> 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -1496,7 +1496,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><code>#multiLine()</code> attribute for <a 
href="#_rgant-Property_multiLine"><code>@Property</code></a> or <a 
href="#_rgant-Parameter_multiLine"><code>@Parameter</code></a></p> 
+              <p><code>#multiLine()</code> attribute for <a 
href="../rgant/rgant.html#_rgant-Property_multiLine"><code>@Property</code></a> 
or <a 
href="../rgant/rgant.html#_rgant-Parameter_multiLine"><code>@Parameter</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -1513,7 +1513,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><code>#mustSatisfy()</code> attribute for <a 
href="#_rgant-Property_mustSatisfy"><code>@Property</code></a> or <a 
href="#_rgant-Parameter_mustSatisfy"><code>@Parameter</code></a></p> 
+              <p><code>#mustSatisfy()</code> attribute for <a 
href="../rgant/rgant.html#_rgant-Property_mustSatisfy"><code>@Property</code></a>
 or <a 
href="../rgant/rgant.html#_rgant-Parameter_mustSatisfy"><code>@Parameter</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1530,7 +1530,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><code>#named()</code> attribute for <a 
href="#_rgant-DomainServiceLayout_named"><code>@DomainServiceLayout</code></a>, 
<a 
href="#_rgant-DomainObjectLayout_named"><code>@DomainObjectLayout</code></a>, 
<a href="#_rgant-PropertyLayout_named"><code>@PropertyLayout</code></a>, <a 
href="#_rgant-CollectionLayout_named"><code>@CollectionLayout</code></a>, <a 
href="#_rgant-ActionLayout_named"><code>@ActionLayout</code></a> and <a 
href="#_rgant-ParameterLayout_named"><code>@ParameterLayout</code></a></p> 
+              <p><code>#named()</code> attribute for <a 
href="../rgant/rgant.html#_rgant-DomainServiceLayout_named"><code>@DomainServiceLayout</code></a>,
 <a 
href="../rgant/rgant.html#_rgant-DomainObjectLayout_named"><code>@DomainObjectLayout</code></a>,
 <a 
href="../rgant/rgant.html#_rgant-PropertyLayout_named"><code>@PropertyLayout</code></a>,
 <a 
href="../rgant/rgant.html#_rgant-CollectionLayout_named"><code>@CollectionLayout</code></a>,
 <a 
href="../rgant/rgant.html#_rgant-ActionLayout_named"><code>@ActionLayout</code></a>
 and <a 
href="../rgant/rgant.html#_rgant-ParameterLayout_named"><code>@ParameterLayout</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -1547,7 +1547,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p>Use <a 
href="#_rgant-DomainService_nature"><code>@DomainService#nature()</code></a> to 
specify whether any of the actions in a domain service should appear in the 
menu bars (applies at type level, not action level). For individual actions, 
use <a 
href="#_rgant-ActionLayout_contributedAs"><code>@ActionLayout#</code><br> 
<code>contributedAs()</code></a> to specify whether any individual action 
should be contributed only as an action or as an association (property or 
collection).</p> 
+              <p>Use <a 
href="../rgant/rgant.html#_rgant-DomainService_nature"><code>@DomainService#nature()</code></a>
 to specify whether any of the actions in a domain service should appear in the 
menu bars (applies at type level, not action level). For individual actions, 
use <a 
href="../rgant/rgant.html#_rgant-ActionLayout_contributedAs"><code>@ActionLayout#</code><br>
 <code>contributedAs()</code></a> to specify whether any individual action 
should be contributed only as an action or as an association (property or 
collection).</p> 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -1564,7 +1564,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-DomainService_nature"><code>@DomainService#nature()</code></a> to 
signify that none of the actions in a domain service should appear in the menu 
bars</p> 
+              <p><a 
href="../rgant/rgant.html#_rgant-DomainService_nature"><code>@DomainService#nature()</code></a>
 to signify that none of the actions in a domain service should appear in the 
menu bars</p> 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -1581,7 +1581,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><code>#notPersisted()</code> attribute of <a 
href="#_rgant-Property_notPersisted"><code>@Property</code></a> and <a 
href="#_rgant-Collection_notPersisted"><code>@Collection</code></a></p> 
+              <p><code>#notPersisted()</code> attribute of <a 
href="../rgant/rgant.html#_rgant-Property_notPersisted"><code>@Property</code></a>
 and <a 
href="../rgant/rgant.html#_rgant-Collection_notPersisted"><code>@Collection</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain, Persistence</p></td> 
@@ -1598,7 +1598,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-DomainObject_objectType"><code>@DomainObject#objectType()</code></a></p>
 
+              <p><a 
href="../rgant/rgant.html#_rgant-DomainObject_objectType"><code>@DomainObject#objectType()</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1615,7 +1615,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><code>#optionality()</code> attribute for <a 
href="#_rgant-Property_optionality"><code>@Property</code></a> or <a 
href="#_rgant-Parameter_optionality"><code>@Parameter</code></a></p> 
+              <p><code>#optionality()</code> attribute for <a 
href="../rgant/rgant.html#_rgant-Property_optionality"><code>@Property</code></a>
 or <a 
href="../rgant/rgant.html#_rgant-Parameter_optionality"><code>@Parameter</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1632,7 +1632,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><code>#paged()</code> attribute for <a 
href="#_rgant-DomainObjectLayout_paged"><code>@DomainObjectLayout</code></a> or 
<a href="#_rgant-CollectionLayout_paged"><code>@CollectionLayout</code></a></p> 
+              <p><code>#paged()</code> attribute for <a 
href="../rgant/rgant.html#_rgant-DomainObjectLayout_paged"><code>@DomainObjectLayout</code></a>
 or <a 
href="../rgant/rgant.html#_rgant-CollectionLayout_paged"><code>@CollectionLayout</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -1649,7 +1649,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-DomainObject_plural"><code>@DomainObjectLayout</code><br> 
<code>#plural()</code></a></p> 
+              <p><a 
href="../rgant/rgant.html#_rgant-DomainObject_plural"><code>@DomainObjectLayout</code><br>
 <code>#plural()</code></a></p> 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -1666,7 +1666,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-Action_domainEvent"><code>@Action#domainEvent()</code></a></p> 
+              <p><a 
href="../rgant/rgant.html#_rgant-Action_domainEvent"><code>@Action#domainEvent()</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1683,7 +1683,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-Collection_domainEvent"><code>@Collection#domainEvent()</code></a></p>
 
+              <p><a 
href="../rgant/rgant.html#_rgant-Collection_domainEvent"><code>@Collection#domainEvent()</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1700,7 +1700,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-Collection_domainEvent"><code>@Collection#domainEvent()</code></a></p>
 
+              <p><a 
href="../rgant/rgant.html#_rgant-Collection_domainEvent"><code>@Collection#domainEvent()</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1717,7 +1717,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-Property_domainEvent"><code>@Property#domainEvent()</code></a></p>
 
+              <p><a 
href="../rgant/rgant.html#_rgant-Property_domainEvent"><code>@Property#domainEvent()</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1734,7 +1734,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-Property_domainEvent"><code>@Property#domainEvent()</code></a></p>
 
+              <p><a 
href="../rgant/rgant.html#_rgant-Property_domainEvent"><code>@Property#domainEvent()</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1751,7 +1751,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-Action_restrictTo"><code>@Action#restrictTo()</code></a></p> 
+              <p><a 
href="../rgant/rgant.html#_rgant-Action_restrictTo"><code>@Action#restrictTo()</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -1768,7 +1768,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-Action_publishing"><code>@Action#publishing()</code></a></p> 
+              <p><a 
href="../rgant/rgant.html#_rgant-Action_publishing"><code>@Action#publishing()</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1785,7 +1785,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-DomainObject_publishing"><code>@DomainObject#publishing()</code></a></p>
 
+              <p><a 
href="../rgant/rgant.html#_rgant-DomainObject_publishing"><code>@DomainObject#publishing()</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1802,7 +1802,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-Action_semantics"><code>@Action#semantics()</code></a></p> 
+              <p><a 
href="../rgant/rgant.html#_rgant-Action_semantics"><code>@Action#semantics()</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1819,7 +1819,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><code>#regexPattern()</code> for <a 
href="#_rgant-Property_regexPattern"><code>@Property</code></a> or <a 
href="#_rgant-Property_regexPattern"><code>@Parameter</code></a>.</p> 
+              <p><code>#regexPattern()</code> for <a 
href="../rgant/rgant.html#_rgant-Property_regexPattern"><code>@Property</code></a>
 or <a 
href="../rgant/rgant.html#_rgant-Property_regexPattern"><code>@Parameter</code></a>.</p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1836,7 +1836,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-CollectionLayout_render"><code>@CollectionLayout</code><br> 
<code>#render()</code></a></p> 
+              <p><a 
href="../rgant/rgant.html#_rgant-CollectionLayout_render"><code>@CollectionLayout</code><br>
 <code>#render()</code></a></p> 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -1853,7 +1853,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><code>#renderedAsDayBefore()</code> attribute for <a 
href="#_rgant-PropertyLayout_renderedAsDayBefore"><code>@PropertyLayout</code></a>
 and <a 
href="#_rgant-ParameterLayout_renderedAsDayBefore"><code>@ParameterLayout</code></a>.</p>
 
+              <p><code>#renderedAsDayBefore()</code> attribute for <a 
href="../rgant/rgant.html#_rgant-PropertyLayout_renderedAsDayBefore"><code>@PropertyLayout</code></a>
 and <a 
href="../rgant/rgant.html#_rgant-ParameterLayout_renderedAsDayBefore"><code>@ParameterLayout</code></a>.</p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -1870,7 +1870,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-CollectionLayout_render"><code>@CollectionLayout</code><br> 
<code>#render()</code></a></p> 
+              <p><a 
href="../rgant/rgant.html#_rgant-CollectionLayout_render"><code>@CollectionLayout</code><br>
 <code>#render()</code></a></p> 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -1887,7 +1887,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><a 
href="#_rgant-CollectionLayout_sortedBy"><code>@CollectionLayout</code><br> 
<code>#sortedBy()</code></a></p> 
+              <p><a 
href="../rgant/rgant.html#_rgant-CollectionLayout_sortedBy"><code>@CollectionLayout</code><br>
 <code>#sortedBy()</code></a></p> 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -1904,7 +1904,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><code>#typeOf()</code> attribute for <a 
href="#_rgant-Collection_typeOf"><code>@Collection</code></a> and <a 
href="#_rgant-Action_typeOf"><code>@Action</code></a></p> 
+              <p><code>#typeOf()</code> attribute for <a 
href="../rgant/rgant.html#_rgant-Collection_typeOf"><code>@Collection</code></a>
 and <a 
href="../rgant/rgant.html#_rgant-Action_typeOf"><code>@Action</code></a></p> 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">Domain</p></td> 
@@ -1921,7 +1921,7 @@
            <td class="tableblock halign-left valign-top">
             <div>
              <div class="paragraph"> 
-              <p><code>#typicalLength()</code> attribute for <a 
href="#_rgant-PropertyLayout_typicalLength"><code>@PropertyLayout</code></a> 
and <a 
href="#_rgant-ParameterLayout_typicalLength"><code>@ParameterLayout</code></a></p>
 
+              <p><code>#typicalLength()</code> attribute for <a 
href="../rgant/rgant.html#_rgant-PropertyLayout_typicalLength"><code>@PropertyLayout</code></a>
 and <a 
href="../rgant/rgant.html#_rgant-ParameterLayout_typicalLength"><code>@ParameterLayout</code></a></p>
 
              </div>
             </div></td> 
            <td class="tableblock halign-left valign-top"><p 
class="tableblock">UI</p></td> 
@@ -2115,12 +2115,12 @@
         </thead> 
         <tbody> 
          <tr> 
-          <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-Action_command"><code>command()</code></a></p></td> 
+          <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-Action_command"><code>command()</code></a></p></td>
 
           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><code>AS_CONFIGURED</code>, <code>ENABLED</code>, 
<code>DISABLED</code><br> (<code>AS_CONFIGURED</code>)</p></td> 
           <td class="tableblock halign-left valign-top">
            <div>
             <div class="paragraph"> 
-             <p>whether the action invocation should be reified into a 
<code>o.a.i.applib.</code><br> <code>services.command.Command</code> object 
through the <a 
href="rgsvc.html#_rgsvc_api_CommandContext"><code>CommandContext</code></a> 
service.</p> 
+             <p>whether the action invocation should be reified into a 
<code>o.a.i.applib.</code><br> <code>services.command.Command</code> object 
through the <a 
href="../rgsvc/rgsvc.html#_rgsvc_api_CommandContext"><code>CommandContext</code></a>
 service.</p> 
             </div>
            </div></td> 
          </tr> 
@@ -2130,7 +2130,7 @@
           <td class="tableblock halign-left valign-top">
            <div>
             <div class="paragraph"> 
-             <p>whether to execute the command immediately, or to persist it 
(assuming that an appropriate implementation of <a 
href="rgsvc.html#_rgsvc_spi_CommandService"><code>CommandService</code></a> has 
been configured) such that a background scheduler can execute the command 
asynchronously</p> 
+             <p>whether to execute the command immediately, or to persist it 
(assuming that an appropriate implementation of <a 
href="../rgsvc/rgsvc.html#_rgsvc_spi_CommandService"><code>CommandService</code></a>
 has been configured) such that a background scheduler can execute the command 
asynchronously</p> 
             </div>
            </div></td> 
          </tr> 
@@ -2140,22 +2140,22 @@
           <td class="tableblock halign-left valign-top">
            <div>
             <div class="paragraph"> 
-             <p>whether the reified <code>Command</code> (as provided by the 
<code>CommandContext</code> domain service) should actually be persisted 
(assuming an appropriate implementation of <a 
href="rgsvc.html#_rgsvc_spi_CommandService"><code>CommandService</code></a> has 
been configured).</p> 
+             <p>whether the reified <code>Command</code> (as provided by the 
<code>CommandContext</code> domain service) should actually be persisted 
(assuming an appropriate implementation of <a 
href="../rgsvc/rgsvc.html#_rgsvc_spi_CommandService"><code>CommandService</code></a>
 has been configured).</p> 
             </div>
            </div></td> 
          </tr> 
          <tr> 
-          <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-Action_domainEvent"><code>domainEvent()</code></a></p></td> 
+          <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-Action_domainEvent"><code>domainEvent()</code></a></p></td>
 
           <td class="tableblock halign-left valign-top"><p 
class="tableblock">subtype of <code>ActionDomainEvent</code><br> 
(<code>ActionDomainEvent.Default</code>)</p></td> 
           <td class="tableblock halign-left valign-top">
            <div>
             <div class="paragraph"> 
-             <p>the event type to be posted to the <a 
href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> 
to broadcast the action’s business rule checking (hide, disable, validate) 
and its invocation (pre-execute and post-execute).</p> 
+             <p>the event type to be posted to the <a 
href="../rgsvc/rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a>
 to broadcast the action’s business rule checking (hide, disable, validate) 
and its invocation (pre-execute and post-execute).</p> 
             </div>
            </div></td> 
          </tr> 
          <tr> 
-          <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-Action_hidden"><code>hidden()</code></a></p></td> 
+          <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-Action_hidden"><code>hidden()</code></a></p></td>
 
           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><code>EVERYWHERE</code>, <code>NOWHERE</code><br> 
(<code>NOWHERE</code>)</p></td> 
           <td class="tableblock halign-left valign-top">
            <div>
@@ -2165,7 +2165,7 @@
            </div></td> 
          </tr> 
          <tr> 
-          <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-Action_invokeOn"><code>invokeOn()</code></a></p></td> 
+          <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-Action_invokeOn"><code>invokeOn()</code></a></p></td>
 
           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><code>OBJECT_ONLY</code>, <code>COLLECTION_ONLY</code>, 
<code>OBJECT_AND_COLLECTION</code><br> (<code>OBJECT_ONLY</code>)</p></td> 
           <td class="tableblock halign-left valign-top">
            <div>
@@ -2178,12 +2178,12 @@
            </div></td> 
          </tr> 
          <tr> 
-          <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-Action_publishing"><code>publishing()</code></a></p></td> 
+          <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-Action_publishing"><code>publishing()</code></a></p></td>
 
           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><code>AS_CONFIGURED</code>, <code>ENABLED</code>, 
<code>DISABLED</code><br> (<code>AS_CONFIGURED</code>)</p></td> 
           <td class="tableblock halign-left valign-top">
            <div>
             <div class="paragraph"> 
-             <p>whether the action invocation should be published to the 
registered <a 
href="rgsvc.html#_rgsvc_spi_PublishingService"><code>PublishingService</code></a>.</p>
 
+             <p>whether the action invocation should be published to the 
registered <a 
href="../rgsvc/rgsvc.html#_rgsvc_spi_PublishingService"><code>PublishingService</code></a>.</p>
 
             </div>
            </div></td> 
          </tr> 
@@ -2198,7 +2198,7 @@
            </div></td> 
          </tr> 
          <tr> 
-          <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-Action_restrictTo"><code>restrictTo()</code></a></p></td> 
+          <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-Action_restrictTo"><code>restrictTo()</code></a></p></td>
 
           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><code>NO_RESTRICTIONS</code>,<code>PROTOTYPING</code><br> 
(<code>NO_RESTRICTIONS</code>)</p></td> 
           <td class="tableblock halign-left valign-top">
            <div>
@@ -2208,7 +2208,7 @@
            </div></td> 
          </tr> 
          <tr> 
-          <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-Action_semantics"><code>semantics()</code></a></p></td> 
+          <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-Action_semantics"><code>semantics()</code></a></p></td>
 
           <td class="tableblock halign-left valign-top"><p 
class="tableblock"><code>SAFE_AND_REQUEST_CACHEABLE</code>, 
<code>SAFE</code>,<br> <code>IDEMPOTENT</code>, 
<code>IDEMPOTENT_ARE_YOU_SURE</code><br> <code>NON_IDEMPOTENT</code>, 
<code>NON_IDEMPOTENT_ARE_YOU_SURE</code> +<br> 
(<code>NON_IDEMPOTENT</code>)</p></td> 
           <td class="tableblock halign-left valign-top">
            <div>
@@ -2216,12 +2216,12 @@
              <p>the action’s semantics (ie whether objects are modified as 
the result of invoking this action, and if so whether reinvoking the action 
would result in no further change; if not whether the results can be cached for 
the remainder of the request).</p> 
             </div> 
             <div class="paragraph"> 
-             <p>The <code>…​ARE_YOU_SURE</code> variants cause a 
confirmation dialog to be displayed in the <a href="ugvw.html">Wicket 
viewer</a>.</p> 
+             <p>The <code>…​ARE_YOU_SURE</code> variants cause a 
confirmation dialog to be displayed in the <a href="../ugvw/ugvw.html">Wicket 
viewer</a>.</p> 
             </div>
            </div></td> 
          </tr> 
          <tr> 
-          <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="#_rgant-Action_typeOf"><code>typeOf()</code></a></p></td> 
+          <td class="tableblock halign-left valign-top"><p 
class="tableblock"><a 
href="../rgant/rgant.html#_rgant-Action_typeOf"><code>typeOf()</code></a></p></td>
 
           <td class="tableblock halign-left valign-top"><p 
class="tableblock">(none)</p></td> 
           <td class="tableblock halign-left valign-top">
            <div>
@@ -2286,14 +2286,14 @@
         </div> 
         <div class="ulist"> 
          <ul> 
-          <li> <p><a 
href="rgsvc.html#_rgsvc_api_CommandContext"><code>CommandContext</code></a></p> 
</li> 
-          <li> <p><a 
href="rgsvc.html#_rgsvc_spi_CommandService"><code>CommandService</code></a></p> 
</li> 
-          <li> <p><a 
href="rgsvc.html#_rgsvc_spi_BackgroundService"><code>BackgroundService</code></a>
 and</p> </li> 
-          <li> <p><a 
href="rgsvc.html#_rgsvc_spi_BackgroundCommandService"><code>BackgroundCommandService</code></a></p>
 </li> 
+          <li> <p><a 
href="../rgsvc/rgsvc.html#_rgsvc_api_CommandContext"><code>CommandContext</code></a></p>
 </li> 
+          <li> <p><a 
href="../rgsvc/rgsvc.html#_rgsvc_spi_CommandService"><code>CommandService</code></a></p>
 </li> 
+          <li> <p><a 
href="../rgsvc/rgsvc.html#_rgsvc_spi_BackgroundService"><code>BackgroundService</code></a>
 and</p> </li> 
+          <li> <p><a 
href="../rgsvc/rgsvc.html#_rgsvc_spi_BackgroundCommandService"><code>BackgroundCommandService</code></a></p>
 </li> 
          </ul> 
         </div> 
         <div class="paragraph"> 
-         <p>Each action invocation is reified by the <a 
href="rgsvc.html#_rgsvc_api_CommandContext"><code>CommandContext</code></a> 
service into a <code>Command</code> object, capturing details of the target 
object, the action, the parameter arguments, the user, a timestamp and so 
on.</p> 
+         <p>Each action invocation is reified by the <a 
href="../rgsvc/rgsvc.html#_rgsvc_api_CommandContext"><code>CommandContext</code></a>
 service into a <code>Command</code> object, capturing details of the target 
object, the action, the parameter arguments, the user, a timestamp and so 
on.</p> 
         </div> 
         <div class="paragraph"> 
          <p>If an appropriate <code>CommandService</code> is configured (for 
example using (non-ASF) <a 
href="http://github.com/isisaddons/isis-module-command";>Isis addons' 
command</a> module), then the <code>Command</code> itself is persisted.</p> 
@@ -2308,17 +2308,17 @@
             <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> 
             <td class="content"> 
              <div class="paragraph"> 
-              <p>If background <code>Command</code>s are used, then an 
external scheduler, using <a 
href="ugbtb.html#_ugbtb_headless-access_BackgroundCommandExecution">headless 
access</a>, must also be configured.</p> 
+              <p>If background <code>Command</code>s are used, then an 
external scheduler, using <a 
href="../ugbtb/ugbtb.html#_ugbtb_headless-access_BackgroundCommandExecution">headless
 access</a>, must also be configured.</p> 
              </div> </td> 
            </tr> 
           </tbody>
          </table> 
         </div> 
         <div class="paragraph"> 
-         <p>The <code>command()</code> attribute determines whether the action 
invocation should be reified into a <code>Command</code> object (by the <a 
href="rgsvc.html#_rgsvc_api_CommandContext"><code>CommandContext</code></a> 
service).</p> 
+         <p>The <code>command()</code> attribute determines whether the action 
invocation should be reified into a <code>Command</code> object (by the <a 
href="../rgsvc/rgsvc.html#_rgsvc_api_CommandContext"><code>CommandContext</code></a>
 service).</p> 
         </div> 
         <div class="paragraph"> 
-         <p>The default is <code>AS_CONFIGURED</code>, meaning that the <a 
href="rgcfg.html#_rgcfg_configuring-core">configuration property</a> 
<code>isis.services.command.actions</code> is used to determine the whether the 
action is reified:</p> 
+         <p>The default is <code>AS_CONFIGURED</code>, meaning that the <a 
href="../rgcfg/rgcfg.html#_rgcfg_configuring-core">configuration property</a> 
<code>isis.services.command.actions</code> is used to determine the whether the 
action is reified:</p> 
         </div> 
         <div class="ulist"> 
          <ul> 
@@ -2346,7 +2346,7 @@
             <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> 
             <td class="content"> 
              <div class="paragraph"> 
-              <p>Note: <code>Command</code> reification does not necessarily 
imply that <code>Command</code> objects will be persisted; that depends on 
whether there is a <a 
href="rgsvc.html#_rgsvc_spi_CommandService"><code>CommandService</code></a> 
configured that will persist said <code>Command</code>s.</p> 
+              <p>Note: <code>Command</code> reification does not necessarily 
imply that <code>Command</code> objects will be persisted; that depends on 
whether there is a <a 
href="../rgsvc/rgsvc.html#_rgsvc_spi_CommandService"><code>CommandService</code></a>
 configured that will persist said <code>Command</code>s.</p> 
              </div> </td> 
            </tr> 
           </tbody>
@@ -2389,7 +2389,7 @@
           </div> 
          </div> 
          <div class="paragraph"> 
-          <p>will suppress the persistence of the <code>Command</code> object 
<em>unless</em> a child background <code>Command</code> has been created in the 
body of the action by way of the <a 
href="rgsvc.html#_rgsvc_api_BackgroundService"><code>BackgroundService</code></a>.</p>
 
+          <p>will suppress the persistence of the <code>Command</code> object 
<em>unless</em> a child background <code>Command</code> has been created in the 
body of the action by way of the <a 
href="../rgsvc/rgsvc.html#_rgsvc_api_BackgroundService"><code>BackgroundService</code></a>.</p>
 
          </div> 
          <div class="paragraph"> 
           <p>On the other hand:</p> 
@@ -2416,7 +2416,7 @@
           <p>For persisted commands, the <code>commandExecuteIn()</code> 
attribute determines whether the <code>Command</code> should be executed in the 
foreground (the default) or executed in the background.</p> 
          </div> 
          <div class="paragraph"> 
-          <p>Background execution means that the command is not executed 
immediately, but is available for a configured <a 
href="rgsvc.html#_rgsvc_spi_BackgroundCommandService"><code>BackgroundCommandService</code></a>
 to execute, eg by way of an in-memory scheduler such as Quartz. See <a 
href="ugbtb.html#_ugbtb_headless-access_BackgroundCommandExecution">here</a> 
for further information on this topic.</p> 
+          <p>Background execution means that the command is not executed 
immediately, but is available for a configured <a 
href="../rgsvc/rgsvc.html#_rgsvc_spi_BackgroundCommandService"><code>BackgroundCommandService</code></a>
 to execute, eg by way of an in-memory scheduler such as Quartz. See <a 
href="../ugbtb/ugbtb.html#_ugbtb_headless-access_BackgroundCommandExecution">here</a>
 for further information on this topic.</p> 
          </div> 
          <div class="paragraph"> 
           <p>For example:</p> 
@@ -2452,7 +2452,7 @@
          </ul> 
         </div> 
         <div class="paragraph"> 
-         <p>Subscribers subscribe through the <a 
href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> 
using either <a href="https://github.com/google/guava";>Guava</a> or <a 
href="http://www.axonframework.org/";>Axon Framework</a> annotations and can 
influence each of these phases.</p> 
+         <p>Subscribers subscribe through the <a 
href="../rgsvc/rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a>
 using either <a href="https://github.com/google/guava";>Guava</a> or <a 
href="http://www.axonframework.org/";>Axon Framework</a> annotations and can 
influence each of these phases.</p> 
         </div> 
         <div class="paragraph"> 
          <p>By default the event raised is 
<code>ActionDomainEvent.Default</code>. For example:</p> 
@@ -2467,7 +2467,7 @@
          </div> 
         </div> 
         <div class="paragraph"> 
-         <p>The <code>domainEvent()</code> attribute allows a custom subclass 
to be emitted allowing more precise subscriptions (to those subclasses) to be 
defined instead. This attribute is also supported for <a 
href="#_rgant-Collection_domainEvent">collections</a> and <a 
href="#_rgant-Property_domainEvent">properties</a>.</p> 
+         <p>The <code>domainEvent()</code> attribute allows a custom subclass 
to be emitted allowing more precise subscriptions (to those subclasses) to be 
defined instead. This attribute is also supported for <a 
href="../rgant/rgant.html#_rgant-Collection_domainEvent">collections</a> and <a 
href="../rgant/rgant.html#_rgant-Property_domainEvent">properties</a>.</p> 
         </div> 
         <div class="paragraph"> 
          <p>For example:</p> 
@@ -2500,7 +2500,7 @@
         <div class="sect3"> 
          <h4 id="_subscribers">3.2.1. Subscribers</h4> 
          <div class="paragraph"> 
-          <p>Subscribers (which must be domain services) subscribe using 
either the <a href="https://github.com/google/guava";>Guava</a> API or (if the 
<a 
href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> 
has been appropriately configured) using the <a 
href="http://www.axonframework.org/";>Axon Framework</a> API. The examples below 
use the Guava API.</p> 
+          <p>Subscribers (which must be domain services) subscribe using 
either the <a href="https://github.com/google/guava";>Guava</a> API or (if the 
<a 
href="../rgsvc/rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a>
 has been appropriately configured) using the <a 
href="http://www.axonframework.org/";>Axon Framework</a> API. The examples below 
use the Guava API.</p> 
          </div> 
          <div class="paragraph"> 
           <p>Subscribers can be either coarse-grained (if they subscribe to 
the top-level event type):</p> 
@@ -2604,7 +2604,7 @@
         <div class="sect3"> 
          <h4 id="_raising_events_programmatically">3.2.3. Raising events 
programmatically</h4> 
          <div class="paragraph"> 
-          <p>Normally events are only raised for interactions through the UI. 
However, events can be raised programmatically either by calling the <a 
href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> 
API directly, or by emulating the UI by wrapping the target object using the <a 
href="rgsvc.html#_rgsvc_api_WrapperFactory"><code>WrapperFactory</code></a> 
domain service.</p> 
+          <p>Normally events are only raised for interactions through the UI. 
However, events can be raised programmatically either by calling the <a 
href="../rgsvc/rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a>
 API directly, or by emulating the UI by wrapping the target object using the 
<a 
href="../rgsvc/rgsvc.html#_rgsvc_api_WrapperFactory"><code>WrapperFactory</code></a>
 domain service.</p> 
          </div> 
         </div> 
        </div> 
@@ -2612,7 +2612,7 @@
         <h3 id="_rgant-Action_hidden">3.3. <code>hidden()</code></h3>
         <button type="button" class="button secondary" 
onclick="window.location.href=&quot;https://github.com/apache/isis/edit/master/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-Action_hidden.adoc&quot;";
 style="float: right; font-size: small; padding: 6px; margin-top: -55px; "><i 
class="fa fa-pencil-square-o"></i>&nbsp;Edit</button> 
         <div class="paragraph"> 
-         <p>Actions can be hidden at the domain-level, indicating that they 
are not visible to the end-user. This attribute can also be applied to <a 
href="#_rgant-Property_hidden">properties</a> and <a 
href="#_rgant-Collection_hidden">collections</a>.</p> 
+         <p>Actions can be hidden at the domain-level, indicating that they 
are not visible to the end-user. This attribute can also be applied to <a 
href="../rgant/rgant.html#_rgant-Property_hidden">properties</a> and <a 
href="../rgant/rgant.html#_rgant-Collection_hidden">collections</a>.</p> 
         </div> 
         <div class="admonitionblock tip"> 
          <table> 
@@ -2621,7 +2621,7 @@
             <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td> 
             <td class="content"> 
              <div class="paragraph"> 
-              <p>It is also possible to use <a 
href="#_rgant-ActionLayout_hidden"><code>@ActionLayout#hidden()</code></a> or 
<a href="ugfun.html#_ugfun_object-layout_dynamic">dynamic layouts</a> such that 
the action can be hidden at the view layer. Both options are provided with a 
view that in the future the view-layer semantics may be under the control of 
(expert) users, whereas domain-layer semantics should never be overridden or 
modified by the user.</p> 
+              <p>It is also possible to use <a 
href="../rgant/rgant.html#_rgant-ActionLayout_hidden"><code>@ActionLayout#hidden()</code></a>
 or <a href="../ugvw/ugvw.html#_ugvw_layout_file-based">file-based layouts</a> 
such that the action can be hidden at the view layer. Both options are provided 
with a view that in the future the view-layer semantics may be under the 
control of (expert) users, whereas domain-layer semantics should never be 
overridden or modified by the user.</p> 
              </div> </td> 
            </tr> 
           </tbody>
@@ -2664,7 +2664,7 @@
             <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> 
             <td class="content"> 
              <div class="paragraph"> 
-              <p>For actions of domain services the visibility is dependent 
upon its <a 
href="#_rgant-DomainService_nature"><code>@DomainService#nature()</code></a> 
and also on whether it is contributed (as per <a 
href="#_rgant-ActionLayout_contributedAs"><code>@ActionLayout#contributedAs()</code></a>).</p>
 
+              <p>For actions of domain services the visibility is dependent 
upon its <a 
href="../rgant/rgant.html#_rgant-DomainService_nature"><code>@DomainService#nature()</code></a>
 and also on whether it is contributed (as per <a 
href="../rgant/rgant.html#_rgant-ActionLayout_contributedAs"><code>@ActionLayout#contributedAs()</code></a>).</p>
 
              </div> </td> 
            </tr> 
           </tbody>
@@ -2749,10 +2749,10 @@
         <h3 id="_rgant-Action_publishing">3.5. <code>publishing()</code></h3>
         <button type="button" class="button secondary" 
onclick="window.location.href=&quot;https://github.com/apache/isis/edit/master/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-Action_publishing.adoc&quot;";
 style="float: right; font-size: small; padding: 6px; margin-top: -55px; "><i 
class="fa fa-pencil-square-o"></i>&nbsp;Edit</button> 
         <div class="paragraph"> 
-         <p>The <code>publishing()</code> attribute determines whether and how 
an action invocation is published via the registered implementation of a <a 
href="rgsvc.html#_rgsvc_spi_PublishingService"><code>PublishingService</code></a>)
 or <a 
href="rgsvc.html#_rgsvc_spi_PublisherService"><code>PublisherService</code></a>.
 This attribute is also supported for <a 
href="#_rgant-DomainObject_publishing">domain objects</a>, where it controls 
whether changed objects are published as events, and for <a 
href="#_rgant_Property_publishing"><code>@Property#publishing()</code></a>, 
where it controls whether property edits are published as events.</p> 
+         <p>The <code>publishing()</code> attribute determines whether and how 
an action invocation is published via the registered implementation of a <a 
href="../rgsvc/rgsvc.html#_rgsvc_spi_PublishingService"><code>PublishingService</code></a>)
 or <a 
href="../rgsvc/rgsvc.html#_rgsvc_spi_PublisherService"><code>PublisherService</code></a>.
 This attribute is also supported for <a 
href="../rgant/rgant.html#_rgant-DomainObject_publishing">domain objects</a>, 
where it controls whether changed objects are published as events, and for <a 
href="../rgant/rgant.html#_rgant_Property_publishing"><code>@Property#publishing()</code></a>,
 where it controls whether property edits are published as events.</p> 
         </div> 
         <div class="paragraph"> 
-         <p>A common use case is to notify external "downstream" systems of 
changes in the state of the Isis application. The default value for the 
attribute is <code>AS_CONFIGURED</code>, meaning that the <a 
href="rgcfg.html#_rgcfg_configuring-core">configuration property</a> 
<code>isis.services.publish.actions</code> is used to determine the whether the 
action is published:</p> 
+         <p>A common use case is to notify external "downstream" systems of 
changes in the state of the Isis application. The default value for the 
attribute is <code>AS_CONFIGURED</code>, meaning that the <a 
href="../rgcfg/rgcfg.html#_rgcfg_configuring-core">configuration property</a> 
<code>isis.services.publish.actions</code> is used to determine the whether the 
action is published:</p> 
         </div> 
         <div class="ulist"> 
          <ul> 
@@ -2812,7 +2812,7 @@
              <td class="icon"> <i class="fa icon-warning" title="Warning"></i> 
</td> 
              <td class="content"> 
               <div class="paragraph"> 
-               <p>Be aware that this attribute is only honoured by the 
(deprecated) <a 
href="rgsvc.html#_rgsvc_spi_PublishingService"><code>PublishingService</code></a>,
 so should itself be considered as deprecated. It is ignored by the replacement 
<a 
href="rgsvc.html#_rgsvc_spi_PublisherService"><code>PublisherService</code></a>,</p>
 
+               <p>Be aware that this attribute is only honoured by the 
(deprecated) <a 
href="../rgsvc/rgsvc.html#_rgsvc_spi_PublishingService"><code>PublishingService</code></a>,
 so should itself be considered as deprecated. It is ignored by the replacement 
<a 
href="../rgsvc/rgsvc.html#_rgsvc_spi_PublisherService"><code>PublisherService</code></a>,</p>
 
               </div> </td> 
             </tr> 
            </tbody>
@@ -2824,7 +2824,7 @@
         <h3 id="_rgant-Action_restrictTo">3.6. <code>restrictTo()</code></h3>
         <button type="button" class="button secondary" 
onclick="window.location.href=&quot;https://github.com/apache/isis/edit/master/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-Action_restrictTo.adoc&quot;";
 style="float: right; font-size: small; padding: 6px; margin-top: -55px; "><i 
class="fa fa-pencil-square-o"></i>&nbsp;Edit</button> 
         <div class="paragraph"> 
-         <p>By default actions are available irrespective of the <a 
href="rgcfg.html#_rgcfg_deployment-types">deployment mode</a>. The 
<code>restrictTo()</code> attribute specifies whether the action should instead 
be restricted to only available in prototyping mode.</p> 
+         <p>By default actions are available irrespective of the <a 
href="../rgcfg/rgcfg.html#_rgcfg_deployment-types">deployment mode</a>. The 
<code>restrictTo()</code> attribute specifies whether the action should instead 
be restricted to only available in prototyping mode.</p> 
         </div> 
         <div class="paragraph"> 
          <p>For example:</p> 
@@ -2852,7 +2852,7 @@
          <p>The <code>semantics()</code> attribute describes whether the 
invocation modifies state of the system, and if so whether it does so 
idempotently. If the action invocation does <em>not</em> modify the state of 
the system, in other words is safe, then it also can beused to specify whether 
the results of the action can be cached automatically for the remainder of the 
request.</p> 
         </div> 
         <div class="paragraph"> 
-         <p>The attribute was originally introduced for the <a 
href="ugvro.html">RestfulObjects viewer</a> in order that action invocations 
could be using the appropriate <code>HTTP</code> verb (<code>GET</code>, 

<TRUNCATED>

Reply via email to