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/12/22 10:34:07 UTC

[4/4] isis-site git commit: ISIS-1243: fixing naming of the domain service API and SPI docs, also fix to asciidoc template.

ISIS-1243: fixing naming of the domain service API and SPI docs, also fix to asciidoc template.


Project: http://git-wip-us.apache.org/repos/asf/isis-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis-site/commit/88a9bc5a
Tree: http://git-wip-us.apache.org/repos/asf/isis-site/tree/88a9bc5a
Diff: http://git-wip-us.apache.org/repos/asf/isis-site/diff/88a9bc5a

Branch: refs/heads/asf-site
Commit: 88a9bc5a1695c03c0f8d728caed00a9c1aac2671
Parents: 554d534
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Tue Dec 22 09:29:17 2015 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Tue Dec 22 09:29:17 2015 +0000

----------------------------------------------------------------------
 content/guides/cg.html                          |  14 +-
 content/guides/rgant.html                       | 176 +++---
 content/guides/rgcfg.html                       |  16 +-
 content/guides/rgcms.html                       |  90 +--
 content/guides/rgsvc.html                       | 588 +++++++++----------
 content/guides/tg.html                          |  16 +-
 content/guides/ugbtb.html                       |  46 +-
 content/guides/ugfun.html                       |  74 +--
 content/guides/ugsec.html                       |   6 +-
 content/guides/ugtst.html                       |  12 +-
 content/guides/ugvro.html                       |   8 +-
 content/guides/ugvw.html                        |  14 +-
 content/migration-notes.html                    |  10 +-
 .../templates/isis-asciidoc-templates-idea.xml  |   2 +-
 14 files changed, 536 insertions(+), 536 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/isis-site/blob/88a9bc5a/content/guides/cg.html
----------------------------------------------------------------------
diff --git a/content/guides/cg.html b/content/guides/cg.html
index 935aebf..5d50f3d 100644
--- a/content/guides/cg.html
+++ b/content/guides/cg.html
@@ -1981,7 +1981,7 @@ TODO
 <li>
 <p><code>xsd</code><br></p>
 <div class="paragraph">
-<p>(<code>1.11.0-SNAPSHOT</code>) Uses the <a href="rgsvc.html#_rgsvc-api_JaxbService"><code>JaxbService</code></a> to generate XSD schemas from any JAXB-annotated view models/DTOs.<br></p>
+<p>(<code>1.11.0-SNAPSHOT</code>) Uses the <a href="rgsvc.html#_rgsvc_api_JaxbService"><code>JaxbService</code></a> to generate XSD schemas from any JAXB-annotated view models/DTOs.<br></p>
 </div>
 <div class="paragraph">
 <p>This is instead of and preferable to using the JAXB <a href="https://jaxb.java.net/2.2.4/docs/schemagen.html">schemagen</a> tool, because it uses the framework&#8217;s support (via <a href="rgant.html#_rgant-XmlJavaValueType"><code>@XmlJavaValueType</code></a>) to translate any references to domain objects into <code>OidDto</code>s (as defined by the Apache Isis <a href="rgcms.html#_rgcms_schema-common">common schema</a>).</p>
@@ -2344,7 +2344,7 @@ different configuration; see the final section for differences.</p>
 <div class="sect2">
 <h3 id="_cg_isis-maven-plugin_swagger">5.3. <code>swagger</code> goal (<code>1.11.0-SNAPSHOT</code>)</h3>
 <div class="paragraph">
-<p>The <code>swagger</code> goal of the <code>isis-maven-plugin</code> uses the <a href="rgsvc.html#_rgsvc-api_SwaggerService"><code>SwaggerService</code></a> to
+<p>The <code>swagger</code> goal of the <code>isis-maven-plugin</code> uses the <a href="rgsvc.html#_rgsvc_api_SwaggerService"><code>SwaggerService</code></a> to
 generate <a href="http://swagger.io">Swagger</a> spec files to describe the public and/or private RESTful APIs exposed by the <a href="ugvro.html">RestfulObjects viewer</a>.</p>
 </div>
 <div class="paragraph">
@@ -2487,7 +2487,7 @@ generate <a href="http://swagger.io">Swagger</a> spec files to describe the publ
 <div class="sect2">
 <h3 id="_cg_isis-maven-plugin_xsd">5.4. <code>xsd</code> goal (<code>1.11.0-SNAPSHOT</code>)</h3>
 <div class="paragraph">
-<p>The <code>xsd</code> goal of the <code>isis-maven-plugin</code> uses the <a href="rgsvc.html#_rgsvc-api_JaxbService"><code>JaxbService</code></a> to
+<p>The <code>xsd</code> goal of the <code>isis-maven-plugin</code> uses the <a href="rgsvc.html#_rgsvc_api_JaxbService"><code>JaxbService</code></a> to
 generate XSD schemas from any JAXB-annotated <a href="ugbtb.html#_ugbtb_more-advanced_view-models">view model/DTOs</a>.</p>
 </div>
 <div class="paragraph">
@@ -7598,10 +7598,10 @@ WIP - cool new feature
 <p>for example:</p>
 </div>
 <div class="paragraph">
-<p><pre>xref:rgsvc.adoc#_rgsvc-api_DomainObjectContainer[`DomainObjectContainer`]</pre></p>
+<p><pre>xref:rgsvc.adoc#_rgsvc_api_DomainObjectContainer[`DomainObjectContainer`]</pre></p>
 </div></div></td>
 <td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p><a href="rgsvc.html#_rgsvc-api_DomainObjectContainer"><code>DomainObjectContainer</code></a></p>
+<p><a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>DomainObjectContainer</code></a></p>
 </div></div></td>
 </tr>
 <tr>
@@ -7623,10 +7623,10 @@ WIP - cool new feature
 <p>for example:</p>
 </div>
 <div class="paragraph">
-<p><pre>xref:rgsvc.adoc#_rgsvc-spi_ContentMappingService[`ContentMappingService`]</pre></p>
+<p><pre>xref:rgsvc.adoc#_rgsvc_spi_ContentMappingService[`ContentMappingService`]</pre></p>
 </div></div></td>
 <td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p><a href="rgsvc.html#_rgsvc-spi_ContentMappingService"><code>ContentMappingService</code></a></p>
+<p><a href="rgsvc.html#_rgsvc_spi_ContentMappingService"><code>ContentMappingService</code></a></p>
 </div></div></td>
 </tr>
 <tr>

http://git-wip-us.apache.org/repos/asf/isis-site/blob/88a9bc5a/content/guides/rgant.html
----------------------------------------------------------------------
diff --git a/content/guides/rgant.html b/content/guides/rgant.html
index d87fe40..4d1aa15 100644
--- a/content/guides/rgant.html
+++ b/content/guides/rgant.html
@@ -1091,7 +1091,7 @@ For use with <code>@ViewModel</code>. If specifying view models using <code>@Dom
 <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.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>
 <td class="tableblock halign-left valign-top"></td>
@@ -1866,7 +1866,7 @@ This annotation  indicates that transient instances of this class may be created
 (<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>
+<code>services.command.Command</code> object through the <a href="rgsvc.html#_rgsvc_api_CommandContext"><code>CommandContext</code></a> service.</p>
 </div></div></td>
 </tr>
 <tr>
@@ -1874,7 +1874,7 @@ This annotation  indicates that transient instances of this class may be created
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>FOREGROUND</code>,<code>BACKGROUND</code><br>
 (<code>FOREGROUND</code>)</p></td>
 <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.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>
 <tr>
@@ -1882,7 +1882,7 @@ This annotation  indicates that transient instances of this class may be created
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>PERSISTED</code>, <code>NOT_PERSISTED</code>, <code>IF_HINTED</code><br>
 (<code>PERSISTED</code>)</p></td>
 <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.html#_rgsvc_spi_CommandService"><code>CommandService</code></a> has been configured).</p>
 </div></div></td>
 </tr>
 <tr>
@@ -1890,7 +1890,7 @@ This annotation  indicates that transient instances of this class may be created
 <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
+<p>the event type to be posted to the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> to
 broadcast the action&#8217;s business rule checking (hide, disable, validate) and its invocation (pre-execute and
 post-execute).</p>
 </div></div></td>
@@ -1919,7 +1919,7 @@ post-execute).</p>
 <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.html#_rgsvc_spi_PublishingService"><code>PublishingService</code></a>.</p>
 </div></div></td>
 </tr>
 <tr>
@@ -2012,21 +2012,21 @@ post-execute).</p>
 <div class="ulist">
 <ul>
 <li>
-<p><a href="rgsvc.html#_rgsvc-api_CommandContext"><code>CommandContext</code></a></p>
+<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>
+<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>
+<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>
+<p><a href="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.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>
@@ -2049,7 +2049,7 @@ post-execute).</p>
 </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.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>
@@ -2087,7 +2087,7 @@ post-execute).</p>
 </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.html#_rgsvc_spi_CommandService"><code>CommandService</code></a> configured that will persist said <code>Command</code>s.</p>
 </div>
 </td>
 </tr>
@@ -2131,7 +2131,7 @@ should then also be persisted (the default), or not persisted, or only if hinted
 </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.html#_rgsvc_api_BackgroundService"><code>BackgroundService</code></a>.</p>
 </div>
 <div class="paragraph">
 <p>On the other hand:</p>
@@ -2158,7 +2158,7 @@ should then also be persisted (the default), or not persisted, or only if hinted
 <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_more-advanced_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.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_more-advanced_headless-access_BackgroundCommandExecution">here</a> for further information on this topic.</p>
 </div>
 <div class="paragraph">
 <p>For example:</p>
@@ -2204,7 +2204,7 @@ returned object from this action is the persisted <code>Command</code> itself.</
 </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.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>
@@ -2257,7 +2257,7 @@ rather than through the constructor.  This substantially reduces the boilerplate
 <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.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>
@@ -2377,8 +2377,8 @@ then no event will be posted.</p>
 <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.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>
 </div>
 </div>
 </div>
@@ -2533,7 +2533,7 @@ wrapping the target object using the <a href="rgsvc.html#_rgsvc-api_WrapperFacto
 <div class="sect2">
 <h3 id="_rgant-Action_publishing">3.5. <code>publishing()</code></h3>
 <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>).  This attribute is also supported for <a href="#_rgant-DomainObject_publishing">domain objects</a>, where it controls whether changed objects 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.html#_rgsvc_spi_PublishingService"><code>PublishingService</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.</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.
@@ -2700,7 +2700,7 @@ The "are you sure" variant requires that the user must explicitly confirm the ac
 </div>
 </div>
 <div class="paragraph">
-<p>Actions that are safe and request-cacheable automatically use the <a href="rgsvc.html#_rgsvc-api_QueryResultsCache"><code>QueryResultsCache</code></a> service to cache the result of the method.  Note though that the results of this caching will only be apparent if the action is invoked from another method using the <a href="rgsvc.html#_rgsvc-api_WrapperFactory"><code>WrapperFactory</code></a> service.</p>
+<p>Actions that are safe and request-cacheable automatically use the <a href="rgsvc.html#_rgsvc_api_QueryResultsCache"><code>QueryResultsCache</code></a> service to cache the result of the method.  Note though that the results of this caching will only be apparent if the action is invoked from another method using the <a href="rgsvc.html#_rgsvc_api_WrapperFactory"><code>WrapperFactory</code></a> service.</p>
 </div>
 <div class="paragraph">
 <p>Continuing the example above, imagine code that loops over a set of <code>Order</code>s where each <code>Order</code> has an associated <code>Customer</code>.  We want to check the credit rating of each <code>Customer</code> (a potentially expensive operation) but we don&#8217;t want to do it more than once per <code>Customer</code>.  Invoking through the <code>WrapperFactory</code> will allow us to accomplish this by exploiting the semantics of <code>checkCredit()</code> action:</p>
@@ -3485,7 +3485,7 @@ can be used instead, eg:</p>
 <td class="tableblock halign-left valign-top"><p class="tableblock">subtype of <code>CollectionDomainEvent</code><br>
 (<code>CollectionDomainEvent.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 collection&#8217;s business rule checking (hide, disable, validate) and its modification (before and after).</p>
+<p>the event type to be posted to the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> to broadcast the collection&#8217;s business rule checking (hide, disable, validate) and its modification (before and after).</p>
 </div></div></td>
 </tr>
 <tr>
@@ -3622,7 +3622,7 @@ so that boilerplate-busting tools such as <a href="https://projectlombok.org/">P
 </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.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="admonitionblock warning">
 <table>
@@ -3704,7 +3704,7 @@ rather than through the constructor.  This substantially reduces the boilerplate
 <div class="sect3">
 <h4 id="_subscribers_2">5.1.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.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>
@@ -3824,8 +3824,8 @@ then no event will be posted.</p>
 <div class="sect3">
 <h4 id="_raising_events_programmatically_2">5.1.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.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>
 </div>
 </div>
 </div>
@@ -3987,7 +3987,7 @@ wrapping the target object using the <a href="rgsvc.html#_rgsvc-api_WrapperFacto
 <div class="sect2">
 <h3 id="_rgant-Collection_notPersisted">5.4. <code>notPersisted()</code></h3>
 <div class="paragraph">
-<p>The (somewhat misnamed) <code>notPersisted()</code> attribute indicates that the collection should be excluded from any snapshots generated by the <a href="rgsvc.html#_rgsvc-api_XmlSnapshotService"><code>XmlSnapshotService</code></a>.  This attribute is also supported for <a href="#_rgant-Property_notPersisted">properties</a>.</p>
+<p>The (somewhat misnamed) <code>notPersisted()</code> attribute indicates that the collection should be excluded from any snapshots generated by the <a href="rgsvc.html#_rgsvc_api_XmlSnapshotService"><code>XmlSnapshotService</code></a>.  This attribute is also supported for <a href="#_rgant-Property_notPersisted">properties</a>.</p>
 </div>
 <div class="admonitionblock warning">
 <table>
@@ -4956,7 +4956,7 @@ can be used instead, eg:</p>
 <p>in the URLs of the <a href="ugvw.html">Wicket viewer</a> (in general and in particular if <a href="ugvw.html#_ugvw_features_hints-and-copy-url">copying URLs</a>)</p>
 </li>
 <li>
-<p>in XML snapshots generated by the <a href="rgsvc.html#_rgsvc-api_XmlSnapshotService"><code>XmlSnapshotService</code></a></p>
+<p>in XML snapshots generated by the <a href="rgsvc.html#_rgsvc_api_XmlSnapshotService"><code>XmlSnapshotService</code></a></p>
 </li>
 </ul>
 </div>
@@ -5045,7 +5045,7 @@ can be used instead, eg:</p>
 <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>indicates whether each of the changed properties of an object should be submitted to the registered <a href="rgsvc.html#_rgsvc-spi_AuditingService"><code>AuditingService</code></a>.</p>
+<p>indicates whether each of the changed properties of an object should be submitted to the registered <a href="rgsvc.html#_rgsvc_spi_AuditingService"><code>AuditingService</code></a>.</p>
 </div></div></td>
 </tr>
 <tr>
@@ -5078,7 +5078,7 @@ can be used instead, eg:</p>
 <td class="tableblock halign-left valign-top"><p class="tableblock">subtype of <code>ObjectCreatedEvent</code><br>
 (<code>ObjectCreatedEvent.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> whenever an instance is created</p>
+<p>the event type to be posted to the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> whenever an instance is created</p>
 </div></div></td>
 </tr>
 <tr>
@@ -5110,7 +5110,7 @@ can be used instead, eg:</p>
 <td class="tableblock halign-left valign-top"><p class="tableblock">subtype of <code>ObjectPersistedEvent</code><br>
 (<code>ObjectPersistedEvent.Default</code>)</p></td>
 <td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>the event type to be posted (<code>1.11.0-SNAPSHOT</code>) to the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a> whenever an instance has just been persisted</p>
+<p>the event type to be posted (<code>1.11.0-SNAPSHOT</code>) to the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> whenever an instance has just been persisted</p>
 </div></div></td>
 </tr>
 <tr>
@@ -5120,7 +5120,7 @@ can be used instead, eg:</p>
 <td class="tableblock halign-left valign-top"><p class="tableblock">subtype of <code>ObjectPersistingEvent</code><br>
 (<code>ObjectPersistingEvent.Default</code>)</p></td>
 <td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>the event type to be posted (<code>1.11.0-SNAPSHOT</code>) to the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a> whenever an instance is about to be persisted</p>
+<p>the event type to be posted (<code>1.11.0-SNAPSHOT</code>) to the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> whenever an instance is about to be persisted</p>
 </div></div></td>
 </tr>
 <tr>
@@ -5128,7 +5128,7 @@ can be used instead, eg:</p>
 <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 changes to the object should be published to the registered <a href="rgsvc.html#_rgsvc-spi_PublishingService"><code>PublishingService</code></a>.</p>
+<p>whether changes to the object should be published to the registered <a href="rgsvc.html#_rgsvc_spi_PublishingService"><code>PublishingService</code></a>.</p>
 </div></div></td>
 </tr>
 <tr>
@@ -5146,7 +5146,7 @@ can be used instead, eg:</p>
 <td class="tableblock halign-left valign-top"><p class="tableblock">subtype of <code>ObjectRemovingEvent</code><br>
 (<code>ObjectRemovingEvent.Default</code>)</p></td>
 <td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>the event type to be posted (<code>1.11.0-SNAPSHOT</code>) to the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a> whenever an instance is about to be deleted</p>
+<p>the event type to be posted (<code>1.11.0-SNAPSHOT</code>) to the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> whenever an instance is about to be deleted</p>
 </div></div></td>
 </tr>
 <tr>
@@ -5156,7 +5156,7 @@ can be used instead, eg:</p>
 <td class="tableblock halign-left valign-top"><p class="tableblock">subtype of <code>ObjectUpdatedEvent</code><br>
 (<code>ObjectUpdatedEvent.Default</code>)</p></td>
 <td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>the event type to be posted (<code>1.11.0-SNAPSHOT</code>) to the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a> whenever an instance has just been updated</p>
+<p>the event type to be posted (<code>1.11.0-SNAPSHOT</code>) to the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> whenever an instance has just been updated</p>
 </div></div></td>
 </tr>
 <tr>
@@ -5166,7 +5166,7 @@ can be used instead, eg:</p>
 <td class="tableblock halign-left valign-top"><p class="tableblock">subtype of <code>ObjectUpdatingEvent</code><br>
 (<code>ObjectUpdatingEvent.Default</code>)</p></td>
 <td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>the event type to be posted (<code>1.11.0-SNAPSHOT</code>) to the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a> whenever an instance is about to be updated</p>
+<p>the event type to be posted (<code>1.11.0-SNAPSHOT</code>) to the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> whenever an instance is about to be updated</p>
 </div></div></td>
 </tr>
 </tbody>
@@ -5199,7 +5199,7 @@ can be used instead, eg:</p>
 <div class="sect2">
 <h3 id="_rgant-DomainObject_auditing">10.1. <code>auditing()</code></h3>
 <div class="paragraph">
-<p>The <code>auditing()</code> attribute indicates that if the object is modified, then each of its changed properties should be submitted to the <a href="rgsvc.html#_rgsvc-spi_AuditingService"><code>AuditingService</code></a>, if one has been configured.</p>
+<p>The <code>auditing()</code> attribute indicates that if the object is modified, then each of its changed properties should be submitted to the <a href="rgsvc.html#_rgsvc_spi_AuditingService"><code>AuditingService</code></a>, if one has been configured.</p>
 </div>
 <div class="paragraph">
 <p>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.audit.objects</code> is used to determine the whether the action is published:</p>
@@ -5402,12 +5402,12 @@ can be used instead, eg:</p>
 <div class="sect2">
 <h3 id="_rgant-DomainObject_createdLifecycleEvent">10.4. createdLifecycleEvent() (<code>1.11.0-SNAPSHOT</code>)</h3>
 <div class="paragraph">
-<p>Whenever a domain object is instantiated or otherwise becomes known to the framework, a "created" lifecycle event is fired.  This is typically when the <a href="rgsvc.html#_rgsvc-api_DomainObjectContainer"><code>DomainObjectContainer</code></a>'s <a href="rgsvc.html#_rgsvc-api_DomainObjectContainer_object-creation-api"><code>newTransientInstance()</code></a> is called;
+<p>Whenever a domain object is instantiated or otherwise becomes known to the framework, a "created" lifecycle event is fired.  This is typically when the <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>DomainObjectContainer</code></a>'s <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer_object-creation-api"><code>newTransientInstance()</code></a> is called;
 it will also happen if the object is simply instantiated with <code>new(&#8230;&#8203;)</code>, and then the container&#8217;s
-<a href="rgsvc.html#_rgsvc-api_DomainObjectContainer_services-api"><code>injectServicesInto(&#8230;&#8203;)</code></a> method is called.</p>
+<a href="rgsvc.html#_rgsvc_api_DomainObjectContainer_services-api"><code>injectServicesInto(&#8230;&#8203;)</code></a> method is called.</p>
 </div>
 <div class="paragraph">
-<p>Subscribers subscribe through the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a> and can
+<p>Subscribers subscribe through the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> and can
 use the event to obtain a reference to the object just created.  The subscriber could then, for example, update the
 object, eg looking up state from some external datastore.</p>
 </div>
@@ -5448,7 +5448,7 @@ attribute is available for other lifecycle events.</p>
 <h4 id="_subscribers_3">10.4.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)
+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>
 </div>
 <div class="paragraph">
@@ -5605,7 +5605,7 @@ then no event will be posted.</p>
 <p>Whenever a persistent domain object is loaded from the database, a "loaded" lifecycle event is fired.</p>
 </div>
 <div class="paragraph">
-<p>Subscribers subscribe through the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a> and can
+<p>Subscribers subscribe through the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> and can
 use the event to obtain a reference to the domain object just loaded.  The subscriber could then, for example, update
 or default values on the object (eg to support on-the-fly migration scenarios).</p>
 </div>
@@ -5646,7 +5646,7 @@ attribute is available for other lifecycle events.</p>
 <h4 id="_subscribers_4">10.6.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)
+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>
 </div>
 <div class="paragraph">
@@ -5819,7 +5819,7 @@ then no event will be posted.</p>
 event is fired.</p>
 </div>
 <div class="paragraph">
-<p>Subscribers subscribe through the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a> and can
+<p>Subscribers subscribe through the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> and can
 use the event to obtain a reference to the domain object.  The subscriber could then, for example, maintain an
 external datastore.</p>
 </div>
@@ -5874,7 +5874,7 @@ attribute is available for other lifecycle events.</p>
 <h4 id="_subscribers_5">10.8.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)
+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>
 </div>
 <div class="paragraph">
@@ -5948,7 +5948,7 @@ then no event will be posted.</p>
 event is fired.</p>
 </div>
 <div class="paragraph">
-<p>Subscribers subscribe through the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a> and can
+<p>Subscribers subscribe through the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> and can
 use the event to obtain a reference to the domain object.  The subscriber could then, for example, update the object,
 or it could use it maintain an external datastore.  One possible application is to maintain a full-text search database using
 <a href="https://lucene.apache.org/">Apache Lucene</a> or similar.</p>
@@ -6006,7 +6006,7 @@ attribute is available for other lifecycle events.</p>
 <h4 id="_subscribers_6">10.9.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)
+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>
 </div>
 <div class="paragraph">
@@ -6096,7 +6096,7 @@ then no event will be posted.</p>
 <p>in the URLs of the <a href="ugvw.html">Wicket viewer</a> (in general and in particular if <a href="ugvw.html#_ugvw_features_hints-and-copy-url">copying URLs</a>)</p>
 </li>
 <li>
-<p>in XML snapshots generated by the <a href="rgsvc.html#_rgsvc-api_XmlSnapshotService"><code>XmlSnapshotService</code></a></p>
+<p>in XML snapshots generated by the <a href="rgsvc.html#_rgsvc_api_XmlSnapshotService"><code>XmlSnapshotService</code></a></p>
 </li>
 </ul>
 </div>
@@ -6154,7 +6154,7 @@ then no event will be posted.</p>
 <div class="sect2">
 <h3 id="_rgant-DomainObject_publishing">10.11. <code>publishing()</code></h3>
 <div class="paragraph">
-<p>The <code>publishing()</code> attribute determines whether and how a modified object instance is published via the registered implementation of a <a href="rgsvc.html#_rgsvc-spi_PublishingService"><code>PublishingService</code></a>).  This attribute is also supported for <a href="#_rgant-Action_publishing">actions</a>, where it controls whether action invocations are published as events.</p>
+<p>The <code>publishing()</code> attribute determines whether and how a modified object instance is published via the registered implementation of a <a href="rgsvc.html#_rgsvc_spi_PublishingService"><code>PublishingService</code></a>).  This attribute is also supported for <a href="#_rgant-Action_publishing">actions</a>, where it controls whether action invocations 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.</p>
@@ -6222,7 +6222,7 @@ then no event will be posted.</p>
 lifecycle event is fired.</p>
 </div>
 <div class="paragraph">
-<p>Subscribers subscribe through the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a> and can
+<p>Subscribers subscribe through the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> and can
 use the event to obtain a reference to the domain object.  The subscriber could then, for example, could use it
 maintain an external datastore.  One possible application is to maintain a full-text search database
 using <a href="https://lucene.apache.org/">Apache Lucene</a> or similar.</p>
@@ -6280,7 +6280,7 @@ attribute is available for other lifecycle events.</p>
 <h4 id="_subscribers_7">10.12.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)
+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>
 </div>
 <div class="paragraph">
@@ -6354,7 +6354,7 @@ then no event will be posted.</p>
 lifecycle event is fired.</p>
 </div>
 <div class="paragraph">
-<p>Subscribers subscribe through the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a> and can
+<p>Subscribers subscribe through the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> and can
 use the event to obtain a reference to the domain object.  The subscriber could then, for example, update the object,
 or it could use it maintain an external datastore.  One possible application is to maintain a full-text search database
 using <a href="https://lucene.apache.org/">Apache Lucene</a> or similar.</p>
@@ -6412,7 +6412,7 @@ attribute is available for other lifecycle events.</p>
 <h4 id="_subscribers_8">10.13.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)
+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>
 </div>
 <div class="paragraph">
@@ -6486,7 +6486,7 @@ then no event will be posted.</p>
 event is fired.</p>
 </div>
 <div class="paragraph">
-<p>Subscribers subscribe through the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a> and can
+<p>Subscribers subscribe through the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> and can
 use the event to obtain a reference to the domain object.</p>
 </div>
 <div class="admonitionblock warning">
@@ -6540,7 +6540,7 @@ attribute is available for other lifecycle events.</p>
 <h4 id="_subscribers_9">10.14.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)
+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>
 </div>
 <div class="paragraph">
@@ -6682,7 +6682,7 @@ then no event will be posted.</p>
 <td class="tableblock halign-left valign-top"><p class="tableblock">subtype of <code>CssClassUiEvent</code><br>
 (<code>CssClassUiEvent.Default</code>)</p></td>
 <td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>the event type to be posted (<code>1.11.0-SNAPSHOT</code>) to the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a> to obtain a CSS class for the domain object.</p>
+<p>the event type to be posted (<code>1.11.0-SNAPSHOT</code>) to the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> to obtain a CSS class for the domain object.</p>
 </div></div></td>
 </tr>
 <tr>
@@ -6697,7 +6697,7 @@ then no event will be posted.</p>
 <td class="tableblock halign-left valign-top"><p class="tableblock">subtype of <code>IconUiEvent</code><br>
 (<code>IconUiEvent.Default</code>)</p></td>
 <td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>the event type to be posted (<code>1.11.0-SNAPSHOT</code>) to the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a> to obtain the icon (name) for the domain object.</p>
+<p>the event type to be posted (<code>1.11.0-SNAPSHOT</code>) to the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> to obtain the icon (name) for the domain object.</p>
 </div></div></td>
 </tr>
 <tr>
@@ -6729,7 +6729,7 @@ then no event will be posted.</p>
 <td class="tableblock halign-left valign-top"><p class="tableblock">subtype of <code>TitleUiEvent</code><br>
 (<code>TitleUiEvent.Default</code>)</p></td>
 <td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>the event type to be posted (<code>1.11.0-SNAPSHOT</code>) to the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a> to obtain the title for the domain object.</p>
+<p>the event type to be posted (<code>1.11.0-SNAPSHOT</code>) to the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> to obtain the title for the domain object.</p>
 </div></div></td>
 </tr>
 </tbody>
@@ -6943,7 +6943,7 @@ in any wrapping <code>&lt;div&gt;</code>s and <code>&lt;span&gt;</code>s that re
 it will take precedence).</p>
 </div>
 <div class="paragraph">
-<p>Subscribers subscribe through the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a> and can
+<p>Subscribers subscribe through the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> and can
 use obtain a reference to the domain object from the event.  From this they can, if they wish, specify a CSS class for
 the domain object using the event&#8217;s API.</p>
 </div>
@@ -7000,7 +7000,7 @@ attribute is available for titles and icons.</p>
 <h4 id="_subscribers_10">11.4.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)
+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>
 </div>
 <div class="paragraph">
@@ -7073,8 +7073,8 @@ then no event will be posted.</p>
 <h4 id="_raising_events_programmatically_3">11.4.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 as a result
-of calling the <a href="rgsvc.html#_rgsvc-api_DomainObjectContainer"><code>DomainObjectContainer</code></a>'s
+by calling the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> API directly, or as a result
+of calling the <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>DomainObjectContainer</code></a>'s
 <code>cssClassOf(&#8230;&#8203;)</code> method.</p>
 </div>
 </div>
@@ -7106,7 +7106,7 @@ object (if possible). This is as an alternative to implementing
 it will take precedence).</p>
 </div>
 <div class="paragraph">
-<p>Subscribers subscribe through the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a> and can
+<p>Subscribers subscribe through the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> and can
 use obtain a reference to the domain object from the event.  From this they can, if they wish, specify an icon name for
 the domain object using the event&#8217;s API.</p>
 </div>
@@ -7163,7 +7163,7 @@ attribute is available for titles and CSS classes.</p>
 <h4 id="_subscribers_11">11.6.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)
+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>
 </div>
 <div class="paragraph">
@@ -7236,8 +7236,8 @@ then no event will be posted.</p>
 <h4 id="_raising_events_programmatically_4">11.6.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 as a result
-of calling the <a href="rgsvc.html#_rgsvc-api_DomainObjectContainer"><code>DomainObjectContainer</code></a>'s
+by calling the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> API directly, or as a result
+of calling the <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>DomainObjectContainer</code></a>'s
 <code>iconNameOf(&#8230;&#8203;)</code> method.</p>
 </div>
 </div>
@@ -7361,7 +7361,7 @@ using the <a href="#_rgant-Title"><code>@Title</code></a> annotation, within the
 <code>title()</code> or <code>@Title</code> are present, then they will take precedence).</p>
 </div>
 <div class="paragraph">
-<p>Subscribers subscribe through the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a> and can
+<p>Subscribers subscribe through the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> and can
 use obtain a reference to the domain object from the event.  From this they can, if they wish, specify a title for
 the domain object using the event&#8217;s API.</p>
 </div>
@@ -7418,7 +7418,7 @@ attribute is available for icon names and CSS classes.</p>
 <h4 id="_subscribers_12">11.10.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)
+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>
 </div>
 <div class="paragraph">
@@ -7492,8 +7492,8 @@ thn no event will be posted.</p>
 <h4 id="_raising_events_programmatically_5">11.10.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 as a result
-of calling the <a href="rgsvc.html#_rgsvc-api_DomainObjectContainer"><code>DomainObjectContainer</code></a>'s
+by calling the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> API directly, or as a result
+of calling the <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>DomainObjectContainer</code></a>'s
 <code>titleOf(&#8230;&#8203;)</code> method.</p>
 </div>
 </div>
@@ -8229,7 +8229,7 @@ you may have a module that defines an SPI service, where multiple other modules
 </td>
 <td class="content">
 <div class="paragraph">
-<p>An alternative and almost equivalent design would be to publish an event using the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a> and implement the domain services as subscribers to
+<p>An alternative and almost equivalent design would be to publish an event using the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> and implement the domain services as subscribers to
 the event.  This alternative design is used in the (non-ASF) <a href="http://github.com/isisaddons/isis-module-poly">Isis addons' poly</a> module, for example.</p>
 </div>
 </td>
@@ -8256,7 +8256,7 @@ container.persist(cust);</code></pre>
 <table>
 <tr>
 <td><i class="conum" data-value="1"></i><b>1</b></td>
-<td>where <code>container</code> is an instance of <a href="rgsvc.html#_rgsvc-api_DomainObjectContainer"><code>DomainObjectContainer</code></a>.</td>
+<td>where <code>container</code> is an instance of <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>DomainObjectContainer</code></a>.</td>
 </tr>
 </table>
 </div>
@@ -9214,7 +9214,7 @@ declaration.</p>
 <p>in the URLs of the <a href="ugvw.html">Wicket viewer</a> (in general and in particular if <a href="ugvw.html#_ugvw_features_hints-and-copy-url">copying URLs</a>)</p>
 </li>
 <li>
-<p>in XML snapshots generated by the <a href="rgsvc.html#_rgsvc-api_XmlSnapshotService"><code>XmlSnapshotService</code></a></p>
+<p>in XML snapshots generated by the <a href="rgsvc.html#_rgsvc_api_XmlSnapshotService"><code>XmlSnapshotService</code></a></p>
 </li>
 </ul>
 </div>
@@ -9359,14 +9359,14 @@ declaration.</p>
 </td>
 <td class="content">
 <div class="paragraph">
-<p>Alternatively, you could inject <a href="rgsvc.html#_rgsvc-api_DomainObjectContainer"><code>DomainObjectContainer</code></a> into the service and read configuration properties using <code>DomainObjectContainer#getProperty(&#8230;&#8203;)</code> and related methods.  Note that when using this latter API only those configuration properties prefixes <code>application.</code> key are provided.</p>
+<p>Alternatively, you could inject <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>DomainObjectContainer</code></a> into the service and read configuration properties using <code>DomainObjectContainer#getProperty(&#8230;&#8203;)</code> and related methods.  Note that when using this latter API only those configuration properties prefixes <code>application.</code> key are provided.</p>
 </div>
 </td>
 </tr>
 </table>
 </div>
 <div class="paragraph">
-<p>A common use case is for domain services that interact with the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a>.  For example:</p>
+<p>A common use case is for domain services that interact with the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a>.  For example:</p>
 </div>
 <div class="listingblock">
 <div class="content">
@@ -9439,7 +9439,7 @@ declaration.</p>
 </table>
 </div>
 <div class="paragraph">
-<p>A common use case is for domain services that interact with the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a>.  For example:</p>
+<p>A common use case is for domain services that interact with the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a>.  For example:</p>
 </div>
 <div class="listingblock">
 <div class="content">
@@ -9488,7 +9488,7 @@ declaration.</p>
 <p>The <code>@javax.jdo.annotation.PrimaryKey</code> annotation is used by JDO/DataNucleus to indicate that a property is used as the primary key for an entity with application-managed identity.</p>
 </div>
 <div class="paragraph">
-<p>Apache Isis also uses this annotation in a very minimal way: to ensure that the framework&#8217;s own logic to initialize newly instantiated objects (eg using <a href="rgsvc.html#_rgsvc-api_DomainObjectContainer"><code>DomainObjectContainer#newTransientInstance(&#8230;&#8203;)</code></a> does not touch the primary key, and also to ensure that the primary key property is always disabled (read-only).</p>
+<p>Apache Isis also uses this annotation in a very minimal way: to ensure that the framework&#8217;s own logic to initialize newly instantiated objects (eg using <a href="rgsvc.html#_rgsvc_api_DomainObjectContainer"><code>DomainObjectContainer#newTransientInstance(&#8230;&#8203;)</code></a> does not touch the primary key, and also to ensure that the primary key property is always disabled (read-only).</p>
 </div>
 <div class="admonitionblock note">
 <table>
@@ -9513,7 +9513,7 @@ declaration.</p>
 <h2 id="_rgant-Programmatic">27. <code>@Programmatic</code></h2>
 <div class="sectionbody">
 <div class="paragraph">
-<p>The <code>@Programmatic</code> annotation causes the method to be excluded completely from the Apache Isis metamodel. This means it won&#8217;t appear in any UI, and it won&#8217;t appear in any <a href="rgsvc.html#_rgsvc-api_MementoService">memento</a>s or <a href="rgsvc.html#_rgsvc-api_XmlSnapshotService">snapshot</a>s.</p>
+<p>The <code>@Programmatic</code> annotation causes the method to be excluded completely from the Apache Isis metamodel. This means it won&#8217;t appear in any UI, and it won&#8217;t appear in any <a href="rgsvc.html#_rgsvc_api_MementoService">memento</a>s or <a href="rgsvc.html#_rgsvc_api_XmlSnapshotService">snapshot</a>s.</p>
 </div>
 <div class="paragraph">
 <p>A common use-case is to ignore implementation-level artifacts. For example:</p>
@@ -9564,7 +9564,7 @@ declaration.</p>
 <td class="tableblock halign-left valign-top"><p class="tableblock">subtype of <code>PropertyDomainEvent</code><br>
 (<code>PropertyDomainEvent.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 property&#8217;s business rule checking (hide, disable, validate) and its modification (before and after).</p>
+<p>the event type to be posted to the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> to broadcast the property&#8217;s business rule checking (hide, disable, validate) and its modification (before and after).</p>
 </div></div></td>
 </tr>
 <tr>
@@ -9727,7 +9727,7 @@ so that boilerplate-busting tools such as <a href="https://projectlombok.org/">P
 </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.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>PropertyDomainEvent.Default</code>. For example:</p>
@@ -9789,7 +9789,7 @@ rather than through the constructor.  This substantially reduces the boilerplate
 <div class="sect3">
 <h4 id="_subscribers_13">28.1.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.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>
@@ -9910,7 +9910,7 @@ then no event will be posted.</p>
 <h4 id="_raising_events_programmatically_6">28.1.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 by
-wrapping the target object using the <a href="rgsvc.html#_rgsvc-api_WrapperFactory"><code>WrapperFactory</code></a> service.</p>
+wrapping the target object using the <a href="rgsvc.html#_rgsvc_api_WrapperFactory"><code>WrapperFactory</code></a> service.</p>
 </div>
 </div>
 </div>
@@ -10211,7 +10211,7 @@ tables. Annotating with <code>@Property(where=Where.NOWHERE)</code> overrides th
 <div class="sect2">
 <h3 id="_rgant-Property_notPersisted">28.6. <code>notPersisted()</code></h3>
 <div class="paragraph">
-<p>The (somewhat misnamed) <code>notPersisted()</code> attribute indicates that the collection should be excluded from any snapshots generated by the <a href="rgsvc.html#_rgsvc-api_XmlSnapshotService"><code>XmlSnapshotService</code></a>.  This attribute is also supported for <a href="#_rgant-Collection_notPersisted">collections</a>.</p>
+<p>The (somewhat misnamed) <code>notPersisted()</code> attribute indicates that the collection should be excluded from any snapshots generated by the <a href="rgsvc.html#_rgsvc_api_XmlSnapshotService"><code>XmlSnapshotService</code></a>.  This attribute is also supported for <a href="#_rgant-Collection_notPersisted">collections</a>.</p>
 </div>
 <div class="admonitionblock warning">
 <table>
@@ -11019,7 +11019,7 @@ can be used instead, eg:</p>
 <p>Although Apache Isis does not (currently) leverage CDI, the semantics are the same as request-scoped service; a new instance is created for each HTTP request, reserved for the exclusive use of all objects interacted with during that request.</p>
 </div>
 <div class="paragraph">
-<p>One of the built-in domain services that uses this annotation is <a href="rgsvc.html#_rgsvc-api_Scratchpad"><code>Scratchpad</code></a>, intended to allow the arbitrary sharing of data between objects.  Here is the full source code of this service is:</p>
+<p>One of the built-in domain services that uses this annotation is <a href="rgsvc.html#_rgsvc_api_Scratchpad"><code>Scratchpad</code></a>, intended to allow the arbitrary sharing of data between objects.  Here is the full source code of this service is:</p>
 </div>
 <div class="listingblock">
 <div class="content">
@@ -11210,7 +11210,7 @@ represented in the URL). As such, view models are immutable.</p>
 <p>The view model&#8217;s memento will be derived from the value of the view model object&#8217;s properties. Any <a href="#<em>rgant-Property_notPersisted"><code>@Property#notPersisted()</code></a> properties will be excluded from the memento, as will any <a href="#_rgant-Programmatic"><code>@Programmatic</code></a> properties. Properties that are merely <a href="#_rgant-Property_hidden">hidden</a> _are</em> included in the memento.</p>
 </div>
 <div class="paragraph">
-<p>Only properties supported by the configured <a href="rgsvc.html#_rgsvc-api_MementoService"><code>MementoService</code></a> can be used. The default implementation supports all the value types and persisted entities.</p>
+<p>Only properties supported by the configured <a href="rgsvc.html#_rgsvc_api_MementoService"><code>MementoService</code></a> can be used. The default implementation supports all the value types and persisted entities.</p>
 </div>
 <div class="paragraph">
 <p>(As of 1.8.0) there are some limitations:
@@ -11551,7 +11551,7 @@ for symmetry with domain objects that have been annotated using <a href="#_rgant
 <p>The JAXB <code>@XmlJavaTypeAdapter</code> annotation (<code>1.11.0-SNAPSHOT</code>) is used with the framework-provided
 <code>PersistentEntityAdapter</code> to instruct JAXB to serialize references to persistent entities using the canonical
 <code>OidDto</code> complex type: the object&#8217;s type and its identifier.  This is the formal XML equivalent to the <code>Bookmark</code>
-provided by the <a href="rgsvc.html#_rgsvc-api_BookmarkService"><code>BookmarkService</code></a>.</p>
+provided by the <a href="rgsvc.html#_rgsvc_api_BookmarkService"><code>BookmarkService</code></a>.</p>
 </div>
 <div class="paragraph">
 <p>For example:</p>
@@ -11596,7 +11596,7 @@ significant advantages:</p>
 <li>
 <p>the view model can be used as a "canonical" DTO, for example when accessing data using the
 <a href="ugvro.html">RestfulObjects viewer</a> in combination with the
-<a href="rgsvc.html#_rgsvc-spi_ContentMappingService"><code>ContentMappingService</code></a>.<br></p>
+<a href="rgsvc.html#_rgsvc_spi_ContentMappingService"><code>ContentMappingService</code></a>.<br></p>
 <div class="paragraph">
 <p>This provides a stable and
 versioned API to access data in XML format using whatever client-side technology may be appropriate.</p>
@@ -11628,7 +11628,7 @@ the object&#8217;s type and its identifier.</p>
 <td class="content">
 <div class="paragraph">
 <p>The memento string for view models is converted into a form compatible with use within a URL.  This is performed by the
-<a href="rgsvc.html#_rgsvc-spi_UrlEncodingService"><code>UrlEncodingService</code></a>, the default implementation of which
+<a href="rgsvc.html#_rgsvc_spi_UrlEncodingService"><code>UrlEncodingService</code></a>, the default implementation of which
 simply encodes to base 64.  If the view model XML graph is too large to be serialized to a string, then an alternative
 implementation (eg which maps XML strings to a GUID, say) can be configured using the technique described in
 <a href="rg.html#_ugfun_how-tos_replacing-default-service-implementations">here</a> in the user guide.</p>

http://git-wip-us.apache.org/repos/asf/isis-site/blob/88a9bc5a/content/guides/rgcfg.html
----------------------------------------------------------------------
diff --git a/content/guides/rgcfg.html b/content/guides/rgcfg.html
index c691385..94e5e72 100644
--- a/content/guides/rgcfg.html
+++ b/content/guides/rgcfg.html
@@ -1404,7 +1404,7 @@ If no configuration property is available, then the defaults is determined by th
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code><br>
 (<code>true</code>)</p></td>
 <td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>Whether to enable TLS for the email SMTP connection (used by <a href="rgsvc.html#_rgsvc-api_EmailService"><code>EmailService</code></a>). <br></p>
+<p>Whether to enable TLS for the email SMTP connection (used by <a href="rgsvc.html#_rgsvc_api_EmailService"><code>EmailService</code></a>). <br></p>
 </div>
 <div class="paragraph">
 <p>NB: note that the key is mis-spelt, (<code>isis.service.email</code> rather than <code>isis.services.email</code>)</p>
@@ -1417,7 +1417,7 @@ If no configuration property is available, then the defaults is determined by th
 </div></div></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">host (<code><em>smtp.gmail.com</em></code>)</p></td>
 <td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>The hostname of the external SMTP provider (used by <a href="rgsvc.html#_rgsvc-api_EmailService"><code>EmailService</code></a>). <br></p>
+<p>The hostname of the external SMTP provider (used by <a href="rgsvc.html#_rgsvc_api_EmailService"><code>EmailService</code></a>). <br></p>
 </div>
 <div class="paragraph">
 <p>NB: note that the key is mis-spelt, (<code>isis.service.email</code> rather than <code>isis.services.email</code>)</p>
@@ -1430,7 +1430,7 @@ If no configuration property is available, then the defaults is determined by th
 </div></div></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">port number (<code><em>587</em></code>)</p></td>
 <td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>The port number for the SMTP service on the the external SMTP host (used by <a href="rgsvc.html#_rgsvc-api_EmailService"><code>EmailService</code></a>). <br></p>
+<p>The port number for the SMTP service on the the external SMTP host (used by <a href="rgsvc.html#_rgsvc_api_EmailService"><code>EmailService</code></a>). <br></p>
 </div>
 <div class="paragraph">
 <p>NB: note that the key is mis-spelt, (<code>isis.service.email</code> rather than <code>isis.services.email</code>)</p>
@@ -1443,7 +1443,7 @@ If no configuration property is available, then the defaults is determined by th
 </div></div></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">email address</p></td>
 <td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>The email address to use for sending out email (used by <a href="rgsvc.html#_rgsvc-api_EmailService"><code>EmailService</code></a>).  <strong>Mandatory</strong>. <br></p>
+<p>The email address to use for sending out email (used by <a href="rgsvc.html#_rgsvc_api_EmailService"><code>EmailService</code></a>).  <strong>Mandatory</strong>. <br></p>
 </div>
 <div class="paragraph">
 <p>NB: note that the key is mis-spelt, (<code>isis.service.email</code> rather than <code>isis.services.email</code>)</p>
@@ -1456,7 +1456,7 @@ If no configuration property is available, then the defaults is determined by th
 </div></div></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">email password</p></td>
 <td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>The corresponding password for the email address to use for sending out email (used by <a href="rgsvc.html#_rgsvc-api_EmailService"><code>EmailService</code></a>).  <strong>Mandatory</strong>. <br></p>
+<p>The corresponding password for the email address to use for sending out email (used by <a href="rgsvc.html#_rgsvc_api_EmailService"><code>EmailService</code></a>).  <strong>Mandatory</strong>. <br></p>
 </div>
 <div class="paragraph">
 <p>NB: note that the key is mis-spelt, (<code>isis.service.email</code> rather than <code>isis.services.email</code>)</p>
@@ -1470,7 +1470,7 @@ If no configuration property is available, then the defaults is determined by th
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>guava</code>, <code>axon</code>,<br>
 FQCN (<code><em>guava</em></code>)</p></td>
 <td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>which implementation to use by the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a> as the underlying event bus.</p>
+<p>which implementation to use by the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> as the underlying event bus.</p>
 </div></div></td>
 </tr>
 <tr>
@@ -1481,7 +1481,7 @@ FQCN (<code><em>guava</em></code>)</p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code><br>
 (<code>false</code>)</p></td>
 <td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>whether a domain service can register with the <a href="rgsvc.html#_rgsvc-api_EventBusService"><code>EventBusService</code></a> after any events have posted.<br></p>
+<p>whether a domain service can register with the <a href="rgsvc.html#_rgsvc_api_EventBusService"><code>EventBusService</code></a> after any events have posted.<br></p>
 </div>
 <div class="paragraph">
 <p>Since this almost certainly constitutes a bug in application code, by default this is disallowed.</p>
@@ -1654,7 +1654,7 @@ FQCN (<code><em>guava</em></code>)</p></td>
 </div>
 </div>
 <div class="paragraph">
-<p>Filtering is supported by the Wicket viewer, and by the <a href="rgsvc.html#<em>rgsvc-api_WrapperFactory"><code>WrapperFactory</code></a> domain service (provided the wrapper&#8217;s execution mode is _not</em> "skip rules").  However the Restful Objects viewer does <em>not</em> currently support filtering.</p>
+<p>Filtering is supported by the Wicket viewer, and by the <a href="rgsvc.html#<em>rgsvc_api_WrapperFactory"><code>WrapperFactory</code></a> domain service (provided the wrapper&#8217;s execution mode is _not</em> "skip rules").  However the Restful Objects viewer does <em>not</em> currently support filtering.</p>
 </div>
 <div class="admonitionblock note">
 <table>