Author: cbrisson
Date: Thu Jul 14 10:00:55 2016
New Revision: 1752611
URL: http://svn.apache.org/viewvc?rev=1752611&view=rev
Log:
[site] changelog and upgrading page
Modified:
velocity/site/cms/trunk/content/engine/devel/upgrading.mdtext
velocity/site/production/engine/devel/changes.html
velocity/site/production/engine/devel/upgrading.html
Modified: velocity/site/cms/trunk/content/engine/devel/upgrading.mdtext
URL:
http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/engine/devel/upgrading.mdtext?rev=1752611&r1=1752610&r2=1752611&view=diff
==============================================================================
--- velocity/site/cms/trunk/content/engine/devel/upgrading.mdtext (original)
+++ velocity/site/cms/trunk/content/engine/devel/upgrading.mdtext Thu Jul 14
10:00:55 2016
@@ -6,9 +6,16 @@ Release with the same major number (1.x)
### Upgrading from Velocity 1.7
-API changes:
+Behavior / API changes:
+ the internal Context API now enforces String keys, this may break custom
Context implementations at compile-time.
++ invalid reference events are now more sparsely sent; they're not sent if
*any* of the following conditions is met:
+
+ + the reference is a quiet reference
+ + the reference could be successfully evaluated but resulted in a null
value
+ + the reference is tested for validity inside an #if / #elseif statement
+
+ The 1.x behavior did send invalid reference events in all those cases.
VTL Syntax changes:
Modified: velocity/site/production/engine/devel/changes.html
URL:
http://svn.apache.org/viewvc/velocity/site/production/engine/devel/changes.html?rev=1752611&r1=1752610&r2=1752611&view=diff
==============================================================================
--- velocity/site/production/engine/devel/changes.html (original)
+++ velocity/site/production/engine/devel/changes.html Thu Jul 14 10:00:55 2016
@@ -316,7 +316,7 @@ h2:hover > .headerlink, h3:hover > .head
<td>
<img src="images/fix.png"/>
</td>
- <td> InvalidReferenceHandler events should not be triggered by null
values, or by references testing inside #if / #elseif. Thanks to Renato Steiner
for his testcase. . Fixes <a
href="https://issues.apache.org/jira/browse/VELOCITY-553";>VELOCITY-553</a>.
</td>
+ <td> InvalidReferenceHandler events should not be triggered by quiet
references, null values, or by references testing inside #if / #elseif. Thanks
to Renato Steiner for his testcase. . Fixes <a
href="https://issues.apache.org/jira/browse/VELOCITY-553";>VELOCITY-553</a>.
</td>
<td>cbrisson</td>
</tr>
<tr>
Modified: velocity/site/production/engine/devel/upgrading.html
URL:
http://svn.apache.org/viewvc/velocity/site/production/engine/devel/upgrading.html?rev=1752611&r1=1752610&r2=1752611&view=diff
==============================================================================
--- velocity/site/production/engine/devel/upgrading.html (original)
+++ velocity/site/production/engine/devel/upgrading.html Thu Jul 14 10:00:55
2016
@@ -225,9 +225,18 @@ h2:hover > .headerlink, h3:hover > .head
<h2 id="upgrading-from-earlier-versions">Upgrading from earlier versions<a
class="headerlink" href="#upgrading-from-earlier-versions" title="Permanent
link">¶</a></h2>
<p>Release with the same major number (1.x) are intended to be drop-in
replacements. However, in most cases the versions of dependency jars must be
adjusted because newer versions of Velocity might require updates.</p>
<h3 id="upgrading-from-velocity-17">Upgrading from Velocity 1.7<a
class="headerlink" href="#upgrading-from-velocity-17" title="Permanent
link">¶</a></h3>
-<p>API changes:</p>
+<p>Behavior / API changes:</p>
<ul>
<li>the internal Context API now enforces String keys, this may break custom
Context implementations at compile-time.</li>
+<li>
+<p>invalid reference events are now more sparsely sent; they're not sent if
<em>any</em> of the following conditions is met:</p>
+<ul>
+<li>the reference is a quiet reference</li>
+<li>the reference could be successfully evaluated but resulted in a null
value</li>
+<li>the reference is tested for validity inside an #if / #elseif statement</li>
+</ul>
+<p>The 1.x behavior did send invalid reference events in all those cases.</p>
+</li>
</ul>
<p>VTL Syntax changes:</p>
<ul>
