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 2016/07/12 05:45:52 UTC
[22/26] isis-site git commit: ISIS-1335: removing -SNAPSHOT for
1.13.0, also migration and release notes
http://git-wip-us.apache.org/repos/asf/isis-site/blob/2c032b24/content/guides/rgant.html
----------------------------------------------------------------------
diff --git a/content/guides/rgant.html b/content/guides/rgant.html
index cb37394..f79f893 100644
--- a/content/guides/rgant.html
+++ b/content/guides/rgant.html
@@ -1045,7 +1045,7 @@ For use with <code>@ViewModel</code>. If specifying view models using <code>@Dom
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgant-Digits"><code>@javax.annotation.</code><br>
<code>Nullable</code></a></p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>(<code>1.13.0-SNAPSHOT</code> Specify that a property/parameter is optional.</p>
+<p>Specify that a property/parameter is optional.</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>
@@ -2548,7 +2548,7 @@ wrapping the target object using the <a href="rgsvc.html#_rgsvc_api_WrapperFacto
<div class="paragraph">
<p>The <code>publishing()</code> attribute determines whether and how an action invocation is published via the registered
implementation of a <a href="rgsvc.html#_rgsvc_spi_PublishingService"><code>PublishingService</code></a>) or
-<a href="rgsvc.html#_rgsvc_spi_PublisherService"><code>PublisherService</code></a> (<code>1.13.0-SNAPSHOT</code>). This attribute is also
+<a href="rgsvc.html#_rgsvc_spi_PublisherService"><code>PublisherService</code></a>. This attribute is also
supported for <a href="#_rgant-DomainObject_publishing">domain objects</a>, where it controls whether changed objects
are published as events, and for <a href="#_rgant_Property_publishing"><code>@Property#publishing()</code></a>, where it controls
whether property edits are published as events.</p>
@@ -2627,8 +2627,7 @@ this should avoid the necessity to query back for additional information.</p>
</td>
<td class="content">
<div class="paragraph">
-<p>Be aware that this attribute is only honoured by the deprecated ( in <code>1.13.0-SNAPSHOT</code>)
-<a href="rgsvc.html#_rgsvc_spi_PublishingService"><code>PublishingService</code></a>, so should itself be considered as deprecated. It
+<p>Be aware that this attribute is only honoured by the (deprecated) <a href="rgsvc.html#_rgsvc_spi_PublishingService"><code>PublishingService</code></a>, so should itself be considered as deprecated. It
is ignored by the replacement <a href="rgsvc.html#_rgsvc_spi_PublisherService"><code>PublisherService</code></a>,</p>
</div>
</td>
@@ -5087,8 +5086,8 @@ can be used instead, eg:</p>
(<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> or
-<a href="rgsvc.html#_rgsvc_spi_AuditerService"><code>AuditerService</code></a> (<code>1.13.0-SNAPSHOT</code>).</p>
+<a href="rgsvc.html#_rgsvc_spi_AuditingService"><code>AuditingService</code></a> (deprecated) or (its replacement)
+<a href="rgsvc.html#_rgsvc_spi_AuditerService"><code>AuditerService</code></a></p>
</div></div></td>
</tr>
<tr>
@@ -5391,7 +5390,7 @@ looking up instances of the domain object using a simple string.</p>
</table>
</div>
<div class="paragraph">
-<p>(As of <code>1.13.0-SNAPSHOT</code>), the autocomplete action can also be a regular method, annotated using <a href="#_rgant_Programmatic"><code>@Programmatic</code></a>:</p>
+<p>The autocomplete action can also be a regular method, annotated using <a href="#_rgant_Programmatic"><code>@Programmatic</code></a>:</p>
</div>
<div class="listingblock">
<div class="content">
@@ -6223,7 +6222,7 @@ then no event will be posted.</p>
<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>) or
-<a href="rgsvc.html#_rgsvc_spi_PublisherService"><code>PublisherService</code></a> (<code>1.13.0-SNAPSHOT</code>). This attribute is also supported
+<a href="rgsvc.html#_rgsvc_spi_PublisherService"><code>PublisherService</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, and for <a href="#_rgant_Property_publishing"><code>@Property#publishing()</code></a>, where it controls whether
property edits are published as events.</p>
@@ -6296,7 +6295,7 @@ this should avoid the necessity to query back for additional information.</p>
</td>
<td class="content">
<div class="paragraph">
-<p>Be aware that this attribute is only honoured by the deprecated ( in <code>1.13.0-SNAPSHOT</code>)
+<p>Be aware that this attribute is only honoured by the (deprecated)
<a href="rgsvc.html#_rgsvc_spi_PublishingService"><code>PublishingService</code></a>, so should itself be considered as deprecated. It
is ignored by the replacement <a href="rgsvc.html#_rgsvc_spi_PublisherService"><code>PublisherService</code></a>,</p>
</div>
@@ -8489,11 +8488,11 @@ so that boilerplate-busting tools such as <a href="https://projectlombok.org/">P
</div>
</div>
<div class="sect1">
-<h2 id="_rgant-Nullable">19. <code>@Nullable</code> (<code>javax</code>) (<code>1.13.0-SNAPSHOT</code>)</h2>
+<h2 id="_rgant-Nullable">19. <code>@Nullable</code> (<code>javax</code>)</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Apache Isis' defaults for properties and parameters is that they are mandatory unless otherwise stated. The
-<code>@javax.annotation.Nullable</code> annotation (<code>1.13.0-SNAPSHOT</code>) is recognized by Apache Isis for both properties and
+<code>@javax.annotation.Nullable</code> annotation is recognized by Apache Isis for both properties and
parameters as means to indicate that the property/parameter is not mandatory.</p>
</div>
<div class="paragraph">
@@ -8639,8 +8638,10 @@ Isis Maven plugin.</p>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgant-Parameter_fileAccept"><code>fileAccept()</code></a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Media type or file extension</p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>(<code>1.13.0-SNAPSHOT</code>) restrict the files to be uploaded to a <a href="rgcms.html#_rgcms_classes_value-types_Blob"><code>Blob</code></a>
- or <a href="rgcms.html#_rgcms_classes_value-types_Clob"><code>Clob</code></a>.</p>
+<p>Hints the file type to be uploaded for <a href="rgcms.html#_rgcms_classes_value-types_Blob"><code>Blob</code></a>
+ or <a href="rgcms.html#_rgcms_classes_value-types_Clob"><code>Clob</code></a>.<br>
+<br>
+ Note that this does not prevent the user from uploading some other file type; rather it merely defaults the file type in the file open dialog.</p>
</div></div></td>
</tr>
<tr>
@@ -8734,9 +8735,9 @@ Isis Maven plugin.</p>
</table>
</div>
<div class="sect2">
-<h3 id="_rgant-Parameter_fileAccept">22.1. <code>fileAccept()</code> (<code>1.13.0-SNAPSHOT</code>)</h3>
+<h3 id="_rgant-Parameter_fileAccept">22.1. <code>fileAccept()</code></h3>
<div class="paragraph">
-<p>The <code>fileAccept()</code> attribute (<code>1.13.0-SNAPSHOT</code>) applies only to <a href="rgcms.html#_rgcms_classes_value-types_Blob"><code>Blob</code></a>
+<p>The <code>fileAccept()</code> attribute applies only to <a href="rgcms.html#_rgcms_classes_value-types_Blob"><code>Blob</code></a>
or <a href="rgcms.html#_rgcms_classes_value-types_Clob"><code>Clob</code></a> parameters, indicating the type of file to accept when
uploading a new value. The attribute is also supported on <a href="#_rgant-Property_fileAccept">properties</a>.</p>
</div>
@@ -8936,7 +8937,7 @@ uploading a new value. The attribute is also supported on <a href="#_rgant-Pro
</td>
<td class="content">
<div class="paragraph">
-<p>It is also possible to specify optionality using <a href="#_rgant_Nullable"><code>@Nullable</code></a> annotation (<code>1.13.0-SNAPSHOT</code>).</p>
+<p>It is also possible to specify optionality using <a href="#_rgant_Nullable"><code>@Nullable</code></a> annotation.</p>
</div>
</td>
</tr>
@@ -9792,8 +9793,10 @@ declaration.</p>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#_rgant-Property_fileAccept"><code>fileAccept()</code></a></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Media type or file extension</p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>(<code>1.13.0-SNAPSHOT</code>) restrict the files to be uploaded to a <a href="rgcms.html#_rgcms_classes_value-types_Blob"><code>Blob</code></a>
- or <a href="rgcms.html#_rgcms_classes_value-types_Clob"><code>Clob</code></a>.</p>
+<p>Hints the files to be uploaded to a <a href="rgcms.html#_rgcms_classes_value-types_Blob"><code>Blob</code></a>
+ or <a href="rgcms.html#_rgcms_classes_value-types_Clob"><code>Clob</code></a>.<br>
+<br>
+Note that this does not prevent the user from uploading some other file type; rather it merely defaults the file type in the file open dialog.</p>
</div></div></td>
</tr>
<tr>
@@ -10193,9 +10196,9 @@ wrapping the target object using the <a href="rgsvc.html#_rgsvc_api_WrapperFacto
</div>
</div>
<div class="sect2">
-<h3 id="_rgant-Property_fileAccept">29.3. <code>fileAccept()</code> (<code>1.13.0-SNAPSHOT</code>)</h3>
+<h3 id="_rgant-Property_fileAccept">29.3. <code>fileAccept()</code></h3>
<div class="paragraph">
-<p>The <code>fileAccept()</code> attribute (<code>1.13.0-SNAPSHOT</code>) applies only to <a href="rgcms.html#_rgcms_classes_value-types_Blob"><code>Blob</code></a>
+<p>The <code>fileAccept()</code> attribute applies only to <a href="rgcms.html#_rgcms_classes_value-types_Blob"><code>Blob</code></a>
or <a href="rgcms.html#_rgcms_classes_value-types_Clob"><code>Clob</code></a> parameters, indicating the type of file to accept when
uploading a new value. The attribute is also supported on <a href="#_rgant-Parameter_fileAccept">parameters</a>.</p>
</div>
@@ -10695,7 +10698,7 @@ tables. Annotating with <code>@Property(where=Where.NOWHERE)</code> overrides th
</td>
<td class="content">
<div class="paragraph">
-<p>It is also possible to specify optionality using <a href="#_rgant_Nullable"><code>@Nullable</code></a> annotation (<code>1.13.0-SNAPSHOT</code>).</p>
+<p>It is also possible to specify optionality using <a href="#_rgant_Nullable"><code>@Nullable</code></a> annotation.</p>
</div>
</td>
</tr>
@@ -12185,12 +12188,12 @@ in the user guide.</p>
</li>
<li><a href="#_rgant-MemberGroupLayout">17. <code>@MemberGroupLayout</code></a></li>
<li><a href="#_rgant-MemberOrder">18. <code>@MemberOrder</code></a></li>
-<li><a href="#_rgant-Nullable">19. <code>@Nullable</code> (<code>javax</code>) (<code>1.13.0-SNAPSHOT</code>)</a></li>
+<li><a href="#_rgant-Nullable">19. <code>@Nullable</code> (<code>javax</code>)</a></li>
<li><a href="#_rgant-NotPersistent">20. <code>@NotPersistent</code> (<code>javax.jdo</code>)</a></li>
<li><a href="#_rgant-MinLength">21. <code>@MinLength</code></a></li>
<li><a href="#_rgant-Parameter">22. <code>@Parameter</code></a>
<ul class="sectlevel2">
-<li><a href="#_rgant-Parameter_fileAccept">22.1. <code>fileAccept()</code> (<code>1.13.0-SNAPSHOT</code>)</a></li>
+<li><a href="#_rgant-Parameter_fileAccept">22.1. <code>fileAccept()</code></a></li>
<li><a href="#_rgant-Parameter_maxLength">22.2. <code>maxLength()</code></a></li>
<li><a href="#_rgant-Parameter_mustSatisfy">22.3. <code>mustSatisfy()</code></a></li>
<li><a href="#_rgant-Parameter_optionality">22.4. <code>optionality()</code></a></li>
@@ -12223,7 +12226,7 @@ in the user guide.</p>
</ul>
</li>
<li><a href="#_rgant-Property_editing">29.2. <code>editing()</code></a></li>
-<li><a href="#_rgant-Property_fileAccept">29.3. <code>fileAccept()</code> (<code>1.13.0-SNAPSHOT</code>)</a></li>
+<li><a href="#_rgant-Property_fileAccept">29.3. <code>fileAccept()</code></a></li>
<li><a href="#_rgant-Property_hidden">29.4. <code>hidden()</code></a></li>
<li><a href="#_rgant-Property_maxLength">29.5. <code>maxLength()</code></a>
<ul class="sectlevel3">