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 2017/01/22 15:55:08 UTC
[12/14] isis-site git commit: ISIS-785: updates to the fundamentals
guide, as prereq to being able to document new functionality.
ISIS-785: updates to the fundamentals guide, as prereq to being able to document new functionality.
Project: http://git-wip-us.apache.org/repos/asf/isis-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis-site/commit/22e1e43b
Tree: http://git-wip-us.apache.org/repos/asf/isis-site/tree/22e1e43b
Diff: http://git-wip-us.apache.org/repos/asf/isis-site/diff/22e1e43b
Branch: refs/heads/asf-site
Commit: 22e1e43ba81dcff53e52ab95e6103c152c3365f4
Parents: c7b9ccf
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Sat Jan 21 17:18:37 2017 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Sat Jan 21 17:18:37 2017 +0000
----------------------------------------------------------------------
content/guides/rgcfg.html | 220 +-
content/guides/rgcfg.pdf | 6186 +++++---
content/guides/rgsvc.html | 73 +-
content/guides/rgsvc.pdf | 7753 ++++-----
content/guides/ugbtb.html | 127 +-
content/guides/ugbtb.pdf | 1558 +-
content/guides/ugfun.html | 793 +-
content/guides/ugfun.pdf | 32871 +++++++++++++++++++++++++++------------
content/guides/ugodn.html | 7 +-
content/guides/ugodn.pdf | 1198 +-
content/guides/ugtst.html | 17 +-
content/guides/ugtst.pdf | 2885 ++--
12 files changed, 34757 insertions(+), 18931 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis-site/blob/22e1e43b/content/guides/rgcfg.html
----------------------------------------------------------------------
diff --git a/content/guides/rgcfg.html b/content/guides/rgcfg.html
index 8da1e8e..4a933fe 100644
--- a/content/guides/rgcfg.html
+++ b/content/guides/rgcfg.html
@@ -1265,7 +1265,8 @@ for Apache Isis and contribute back to the project)</p>
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.services.</code><br>
-<code>applicationFeatures.init</code></p>
+<code>applicationFeatures.</code><br>
+<code>init</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>lazy</code>, <code>eager</code><br>
(<code>lazy</code>)</p></td>
@@ -1280,7 +1281,8 @@ initialized lazily or eagerly. <br></p>
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.services.</code><br>
-<code>audit.objects</code></p>
+<code>audit.</code><br>
+<code>objects</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>all</code>, <code>none</code><br>
(<code>all</code>)</p></td>
@@ -1291,7 +1293,8 @@ initialized lazily or eagerly. <br></p>
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.services.</code><br>
-<code>command.actions</code></p>
+<code>command.</code><br>
+<code>actions</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>all</code>, <code>ignoreSafe</code>, <code>none</code> (<code>all</code>)</p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
@@ -1304,7 +1307,8 @@ initialized lazily or eagerly. <br></p>
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.services.</code><br>
-<code>command.properties</code></p>
+<code>command.</code><br>
+<code>properties</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>all</code>, <code>none</code> (<code>all</code>)</p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
@@ -1314,7 +1318,8 @@ initialized lazily or eagerly. <br></p>
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.services.</code><br>
-<code>container.disableAutoFlush</code></p>
+<code>container.</code><br>
+<code>disableAutoFlush</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code><br>
(<code>false</code>)</p></td>
@@ -1342,12 +1347,12 @@ If no configuration property is available, then the defaults is determined by th
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.service.</code><br>
-<code>email.tls.enabled</code></p>
+<code>email.</code><br>
+<code>override.bcc</code><br></p>
</div></div></td>
-<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"><p class="tableblock">email address</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>(<code>1.13.3-SNAPSHOT</code>) intended to simplify testing, if specified then the email’s <code>bcc</code> address will be that specified (rather than the email address(es) passed in as an argument to <code>EmailService#send(…​)</code>). <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>
@@ -1356,11 +1361,26 @@ If no configuration property is available, then the defaults is determined by th
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.service.</code><br>
-<code>email.sender.hostname</code><br></p>
+<code>email.</code><br>
+<code>override.cc</code><br></p>
</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"><p class="tableblock">email address</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>(<code>1.13.3-SNAPSHOT</code>) intended to simplify testing, if specified then the email’s <code>cc</code> address will be that specified (rather than the email address(es) passed in as an argument to <code>EmailService#send(…​)</code>). <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>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><code>isis.service.</code><br>
+<code>email.</code><br>
+<code>override.to</code><br></p>
+</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>(<code>1.13.3-SNAPSHOT</code>) intended to simplify testing, if specified then the email’s <code>to</code> address will be that specified (rather than the email address(es) passed in as an argument to <code>EmailService#send(…​)</code>). <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>
@@ -1369,7 +1389,8 @@ If no configuration property is available, then the defaults is determined by th
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.service.</code><br>
-<code>email.port</code><br></p>
+<code>email.</code><br>
+<code>port</code><br></p>
</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">
@@ -1382,11 +1403,13 @@ If no configuration property is available, then the defaults is determined by th
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.service.</code><br>
-<code>email.sender.address</code><br></p>
+<code>email.</code><br>
+<code>sender.address</code><br></p>
</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>
@@ -1395,11 +1418,90 @@ If no configuration property is available, then the defaults is determined by th
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.service.</code><br>
-<code>email.sender.password</code><br></p>
+<code>email.</code><br>
+<code>sender.hostname</code><br></p>
+</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>
+</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>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><code>isis.service.</code><br>
+<code>email.</code><br>
+<code>sender.password</code><br></p>
</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>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><code>isis.service.</code><br>
+<code>email.</code><br>
+<code>socketConnectionTimeout</code></p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">milliseconds<br>
+(2000)</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>(<code>1.13.3-SNAPSHOT</code>) The socket connection timeout</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>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><code>isis.service.</code><br>
+<code>email.</code><br>
+<code>socketTimeout</code></p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">milliseconds<br>
+(2000)</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>(<code>1.13.3-SNAPSHOT</code>) The socket timeout</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>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><code>isis.service.</code><br>
+<code>email.</code><br>
+<code>throwExceptionOnFail</code></p>
+</div></div></td>
+<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>(<code>1.13.3-SNAPSHOT</code>) Whether to throw an exception if there the email cannot be sent (probably because of some misconfiguration).</p>
+</div>
+<div class="paragraph">
+<p>This behaviour is (now) the default; the old behaviour (of just returning <code>false</code> from the <code>send()</code> method) can be re-enabled by setting this property to <code>false</code>.</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>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><code>isis.service.</code><br>
+<code>email.</code><br>
+<code>tls.enabled</code></p>
+</div></div></td>
+<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>
</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>
@@ -1408,7 +1510,8 @@ If no configuration property is available, then the defaults is determined by th
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.services.</code><br>
-<code>eventbus.implementation</code><br></p>
+<code>eventbus.</code><br>
+<code>implementation</code><br></p>
</div></div></td>
<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>
@@ -1419,7 +1522,8 @@ FQCN (<code><em>guava</em></code>)</p></td>
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.services.</code><br>
-<code>eventbus.allowLateRegistration</code><br></p>
+<code>eventbus.</code><br>
+<code>allowLateRegistration</code><br></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code><br>
(<code>false</code>)</p></td>
@@ -1433,7 +1537,8 @@ FQCN (<code><em>guava</em></code>)</p></td>
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.services.</code><br>
-<code>exceprecog.logRecognizedExceptions</code><br></p>
+<code>exceprecog.</code><br>
+<code>logRecognizedExceptions</code><br></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code><br>
(<code>false</code>)</p></td>
@@ -1441,14 +1546,16 @@ FQCN (<code><em>guava</em></code>)</p></td>
<p>whether recognized exceptions should also be logged.<br></p>
</div>
<div class="paragraph">
-<p>Generally a recognized exception is one that is expected (for example a uniqueness constraint violated in the database) and which does not represent an error condition. This property logs the exception anyway, useful for debugging.</p>
+<p>Generally a recognized exception is one that is expected (for example a uniqueness constraint violated in the database) and which does not represent an error condition.
+This property logs the exception anyway, useful for debugging.</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.services.</code><br>
<code>ExceptionRecognizerComposite-</code><br>
-<code>ForJdoObjectStore.disable</code><br></p>
+<code>ForJdoObjectStore.</code><br>
+<code>disable</code><br></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code><br>
(<code>false</code>)</p></td>
@@ -1456,13 +1563,15 @@ FQCN (<code><em>guava</em></code>)</p></td>
<p>whether to disable the default recognizers registered by <code>ExceptionRecognizerCompositeForJdoObjectStore</code>.<br></p>
</div>
<div class="paragraph">
-<p>This implementation provides a default set of recognizers to convert RDBMS constraints into user-friendly messages. In the (probably remote) chance that this functionality isn’t required, they can be disabled through this flag.</p>
+<p>This implementation provides a default set of recognizers to convert RDBMS constraints into user-friendly messages.
+In the (probably remote) chance that this functionality isn’t required, they can be disabled through this flag.</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.services.</code><br>
-<code>injector.injectPrefix</code></p>
+<code>injector.</code><br>
+<code>injectPrefix</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code> <br>
(<code>false</code>)</p></td>
@@ -1471,13 +1580,16 @@ FQCN (<code><em>guava</em></code>)</p></td>
</div>
<div class="paragraph">
<p>+
-By default this is disabled. The default prior to <code>1.13.0</code> was enabled. If the setting is left as disabled then this may reduce application start-up times.</p>
+By default this is disabled.
+The default prior to <code>1.13.0</code> was enabled.
+If the setting is left as disabled then this may reduce application start-up times.</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.services.</code><br>
-<code>injector.setPrefix</code></p>
+<code>injector.</code><br>
+<code>setPrefix</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code> <br>
(<code>true</code>)</p></td>
@@ -1486,13 +1598,15 @@ By default this is disabled. The default prior to <code>1.13.0</code> was enabl
</div>
<div class="paragraph">
<p>+
-By default this is enabled (no change in <code>1.13.0</code>). If the setting is changed to disabled then this may reduce application start-up times.</p>
+By default this is enabled (no change in <code>1.13.0</code>).
+If the setting is changed to disabled then this may reduce application start-up times.</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.services.</code><br>
-<code>publish.objects</code></p>
+<code>publish.</code><br>
+<code>objects</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>all</code>, <code>none</code><br>
(<code>all</code>)</p></td>
@@ -1503,7 +1617,8 @@ By default this is enabled (no change in <code>1.13.0</code>). If the setting i
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.services.</code><br>
-<code>publish.actions</code></p>
+<code>publish.</code><br>
+<code>actions</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>all</code>, <code>ignoreSafe</code>, <code>none</code> (<code>none</code>)</p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
@@ -1513,7 +1628,8 @@ By default this is enabled (no change in <code>1.13.0</code>). If the setting i
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.services.</code><br>
-<code>publish.properties</code></p>
+<code>publish.</code><br>
+<code>properties</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>all</code>, <code>none</code> (<code>none</code>)</p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
@@ -1537,7 +1653,8 @@ By default this is enabled (no change in <code>1.13.0</code>). If the setting i
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.services.</code><br>
-<code>translation.po.mode</code></p>
+<code>translation.</code><br>
+<code>po.mode</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>read</code>,<code>write</code></p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
@@ -1643,7 +1760,8 @@ By default this is enabled (no change in <code>1.13.0</code>). If the setting i
</div>
<div class="paragraph">
<p>+
-To customize the programming model, use <code>facets.exclude</code> and <code>facets.include</code>. See <a href="ugbtb.html#_ugbtb_programming-model_finetuning">finetuning the programming model</a> for more details.</p>
+To customize the programming model, use <code>facets.exclude</code> and <code>facets.include</code>.
+See <a href="ugbtb.html#_ugbtb_programming-model_finetuning">finetuning the programming model</a> for more details.</p>
</div></div></td>
</tr>
<tr>
@@ -1671,15 +1789,14 @@ To customize the programming model, use <code>facets.exclude</code> and <code>fa
</div>
<div class="paragraph">
<p>+
-By default all deprecated facets are honoured; they remain part of the metamodel. If instead this property is set to
-<code>true</code> then the facets are simply not loaded into the metamodel and their semantics will be excluded. <br></p>
+By default all deprecated facets are honoured; they remain part of the metamodel.
+If instead this property is set to <code>true</code> then the facets are simply not loaded into the metamodel and their semantics will be excluded. <br></p>
</div>
<div class="paragraph">
<p>+
-In most cases this should reduce the start-up times for the application. However, be aware that this could also
-substantially alter the semantics of your application. To be safe, we recommend that you first run your application
-using <code>isis.reflector.validator.allowDeprecated</code> set to <code>false</code>; if any deprecated annotations etc. are in use, then
-the app will fail-fast and refuse to start.</p>
+In most cases this should reduce the start-up times for the application.
+However, be aware that this could also substantially alter the semantics of your application.
+To be safe, we recommend that you first run your application using <code>isis.reflector.validator.allowDeprecated</code> set to <code>false</code>; if any deprecated annotations etc. are in use, then the app will fail-fast and refuse to start.</p>
</div></div></td>
</tr>
<tr>
@@ -1726,7 +1843,8 @@ See <a href="ugbtb.html#_ugbtb_programming-model_finetuning">finetuning the prog
<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 deprecated annotations or naming conventions are tolerated or not. If not, then a metamodel validation error will be triggered, meaning the app won’t boot (fail-fast).<br></p>
+<p>Whether deprecated annotations or naming conventions are tolerated or not.
+If not, then a metamodel validation error will be triggered, meaning the app won’t boot (fail-fast).<br></p>
</div>
<div class="paragraph">
<p>+
@@ -1779,7 +1897,8 @@ See also <code>isis.reflector.facets.ignoreDeprecated</code>.</p>
</ul>
</div>
<div class="paragraph">
-<p>If an action returns a collection that includes the object, then the object will be excluded from the list when rendered. If it returns a single object and the user does not have access to that object, then the action will seemingly return <code>null</code></p>
+<p>If an action returns a collection that includes the object, then the object will be excluded from the list when rendered.
+If it returns a single object and the user does not have access to that object, then the action will seemingly return <code>null</code></p>
</div>
<div class="ulist">
<ul>
@@ -1812,7 +1931,8 @@ See also <code>isis.reflector.facets.ignoreDeprecated</code>.</p>
<p>If an object is returned in a list of choices or within an auto-complete list, and the user does not have access, then it is excluded from the rendered list.</p>
</div>
<div class="paragraph">
-<p>The original motivation for this feature was to transparently support such features as multi-tenancy (as per the (non-ASF) <a href="http://github.com/isisaddons/isis-module-security">Isis addons' security</a> module). That is, if an entity is logically "owned" by a user, then the multi-tenancy support can be arranged to prevent some other user from viewing that object.</p>
+<p>The original motivation for this feature was to transparently support such features as multi-tenancy (as per the (non-ASF) <a href="http://github.com/isisaddons/isis-module-security">Isis addons' security</a> module).
+That is, if an entity is logically "owned" by a user, then the multi-tenancy support can be arranged to prevent some other user from viewing that object.</p>
</div>
<div class="paragraph">
<p>By default this configuration property is enabled. To disable the visibility filtering, set the appropriate configuration property to <code>false</code>:</p>
@@ -1823,9 +1943,7 @@ See also <code>isis.reflector.facets.ignoreDeprecated</code>.</p>
</div>
</div>
<div class="paragraph">
-<p>Filtering is supported by the <a href="ugvw.html">Wicket viewer</a> and the <a href="ugvro.html">Restful Objects viewer</a>, and also
-by the <a href="rgsvc.html#_rgsvc_api_WrapperFactory"><code>WrapperFactory</code></a> domain service (provided the wrapper’s execution
-mode is <em>not</em> "skip rules").</p>
+<p>Filtering is supported by the <a href="ugvw.html">Wicket viewer</a> and the <a href="ugvro.html">Restful Objects viewer</a>, and also by the <a href="rgsvc.html#_rgsvc_api_WrapperFactory"><code>WrapperFactory</code></a> domain service (provided the wrapper’s execution mode is <em>not</em> "skip rules").</p>
</div>
<div class="admonitionblock note">
<table>
@@ -1835,13 +1953,11 @@ mode is <em>not</em> "skip rules").</p>
</td>
<td class="content">
<div class="paragraph">
-<p>In order for the framework to perform this filtering of collections, be aware that the framework takes a <em>copy</em> of the
-original collection, filters on the collection, and returns that filtered collection rather than the original.</p>
+<p>In order for the framework to perform this filtering of collections, be aware that the framework takes a <em>copy</em> of the original collection, filters on the collection, and returns that filtered collection rather than the original.</p>
</div>
<div class="paragraph">
-<p>There are no major side-effects from this algorithm, other than the fact that the referenced objects will (most likely)
-need to be resolved in order to determine if they are visible. This could conceivably have a performance impact in
-some cases.</p>
+<p>There are no major side-effects from this algorithm, other than the fact that the referenced objects will (most likely) need to be resolved in order to determine if they are visible.
+This could conceivably have a performance impact in some cases.</p>
</div>
</td>
</tr>
@@ -1865,8 +1981,7 @@ some cases.</p>
<div class="sect3">
<h4 id="_rgcfg_configuring-core_isis-viewers-propertyLayout-labelPosition">5.5.3. <code>propertyLayout.labelPosition</code></h4>
<div class="paragraph">
-<p>If you want a consistent look-n-feel throughout the app, eg all property labels to the top, then it’d be rather
-frustrating to have to annotate every property.</p>
+<p>If you want a consistent look-n-feel throughout the app, eg all property labels to the top, then it’d be rather frustrating to have to annotate every property.</p>
</div>
<div class="paragraph">
<p>Instead, a default can be specified in <code>isis.properties</code>:</p>
@@ -1885,7 +2000,8 @@ frustrating to have to annotate every property.</p>
</div>
</div>
<div class="paragraph">
-<p>If these are not present then Apache Isis will render according to internal defaults. At the time of writing, this means labels are to the left for all datatypes except multiline strings.</p>
+<p>If these are not present then Apache Isis will render according to internal defaults.
+At the time of writing, this means labels are to the left for all datatypes except multiline strings.</p>
</div>
</div>
</div>