You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@velocity.apache.org by cb...@apache.org on 2017/08/28 08:54:38 UTC
svn commit: r1806415 - in /velocity/site/production: download.html
engine/2.0/upgrading.html engine/devel/upgrading.html
Author: cbrisson
Date: Mon Aug 28 08:54:38 2017
New Revision: 1806415
URL: http://svn.apache.org/viewvc?rev=1806415&view=rev
Log:
[site] Push last changes into production
Modified:
velocity/site/production/download.html
velocity/site/production/engine/2.0/upgrading.html
velocity/site/production/engine/devel/upgrading.html
Modified: velocity/site/production/download.html
URL: http://svn.apache.org/viewvc/velocity/site/production/download.html?rev=1806415&r1=1806414&r2=1806415&view=diff
==============================================================================
--- velocity/site/production/download.html (original)
+++ velocity/site/production/download.html Mon Aug 28 08:54:38 2017
@@ -262,6 +262,15 @@ The <tt>MD5</tt> links download the chec
<p>These releases are considered stable and suitable for production.</p>
<h3 id="engine">Engine<a class="headerlink" href="#engine" title="Permanent link">¶</a></h3>
<p>Be sure to check the <a href="https://dist.apache.org/repos/dist/release/velocity/engine/2.0/release-notes.html">release notes</a> and the <a href="http://velocity.apache.org/engine/devel/dependencies.html">dependencies</a>.</p>
+<h4 id="inclusion-as-a-maven-dependency">Inclusion as a maven dependency<a class="headerlink" href="#inclusion-as-a-maven-dependency" title="Permanent link">¶</a></h4>
+<div class="codehilite"><pre><span class="nt"><dependency></span>
+ <span class="nt"><groupId></span>org.apache.velocity<span class="nt"></groupId></span>
+ <span class="nt"><artifactId></span>velocity-engine-core<span class="nt"></artifactId></span>
+ <span class="nt"><version></span>2.0<span class="nt"></version></span>
+<span class="nt"></dependency></span>
+</pre></div>
+
+
<h4 id="binaries">Binaries<a class="headerlink" href="#binaries" title="Permanent link">¶</a></h4>
<table class="smalltable">
<thead>
Modified: velocity/site/production/engine/2.0/upgrading.html
URL: http://svn.apache.org/viewvc/velocity/site/production/engine/2.0/upgrading.html?rev=1806415&r1=1806414&r2=1806415&view=diff
==============================================================================
--- velocity/site/production/engine/2.0/upgrading.html (original)
+++ velocity/site/production/engine/2.0/upgrading.html Mon Aug 28 08:54:38 2017
@@ -237,6 +237,7 @@ Please note that the maven repository pa
<p>For busy people: To maximize backward compatibility with Velocity 1.x, be sure to include the following lines in your Velocity configuration:</p>
<div class="codehilite"><pre>runtime.conversion.handler = none
space.gobbling = bc
+directive.if.emptycheck = false
</pre></div>
@@ -259,7 +260,7 @@ space.gobbling = bc
<li>Initialization methods in Velocity and VelocityEngine taking an ExtendedProperties have been removed (but <code>setProperties(Properties)</code> methods are still here). All occurences of the org.apache.commons.collections.ExtendedProperties class in the runtime internal initialization API have been replaced by org.apache.velocity.util.ExtProperties.</li>
<li>the macros are now using a 'call by sharing' convention (which means that all arguments are evaluated once at start, and that the macro receives a copy of the reference to each argument).</li>
<li>the <code>UberspectLoggable</code> interface has been removed.</li>
-<li>the <code>directive.if.tostring.nullcheck</code> configuration property has been superseded by the <code>directive.if.emptycheck</code> property.</li>
+<li>the <code>directive.if.tostring.nullcheck</code> configuration property has been superseded by the <code>directive.if.emptycheck</code> property, which defaults to true. It means that all empty objects (strings and collections) as long as zero numbers, do evaluate to false (see the complete <a href="configuration.html#if-directive">boolean context evaluation</a> rules.). You may want to set <code>directive.if.emptycheck</code> to false to maximize backward compatibility with 1.x.</li>
</ul>
<h3 id="vtl-changes">VTL Changes:<a class="headerlink" href="#vtl-changes" title="Permanent link">¶</a></h3>
<ul>
@@ -267,6 +268,7 @@ space.gobbling = bc
<li>method arguments can be arithmetic expressions</li>
<li>method arguments are now converted as needed between all main basic Java standard types (booleans, numbers and strings). If you want to revert to the 1.x behavior, set the property <code>runtime.conversion.handler = none</code>.</li>
<li>space gobbling (to control the indentation of generated code) is now configurable via the <code>space.gobbing</code> configuration key, which can take the following values: <code>none</code>, <code>bc</code> (aka. backward compatible), <code>lines</code> and <code>structured</code>. See the related documentation section for details. To maximize backward compatibility with 1.x, set it to <code>bc</code>.</li>
+<li>The #foreach predefined references <code>$velocityCount</code> and <code>$velocityHasNext</code> have been removed. Use <code>$foreach.count</code> (1-based), <code>$foreach.index</code> (0-based) and <code>foreach.hasNext()</code>.</li>
</ul>
<h3 id="dependency-changes">Dependency changes:<a class="headerlink" href="#dependency-changes" title="Permanent link">¶</a></h3>
<ul>
Modified: velocity/site/production/engine/devel/upgrading.html
URL: http://svn.apache.org/viewvc/velocity/site/production/engine/devel/upgrading.html?rev=1806415&r1=1806414&r2=1806415&view=diff
==============================================================================
--- velocity/site/production/engine/devel/upgrading.html (original)
+++ velocity/site/production/engine/devel/upgrading.html Mon Aug 28 08:54:38 2017
@@ -237,6 +237,7 @@ Please note that the maven repository pa
<p>For busy people: To maximize backward compatibility with Velocity 1.x, be sure to include the following lines in your Velocity configuration:</p>
<div class="codehilite"><pre>runtime.conversion.handler = none
space.gobbling = bc
+directive.if.emptycheck = false
</pre></div>
@@ -259,7 +260,7 @@ space.gobbling = bc
<li>Initialization methods in Velocity and VelocityEngine taking an ExtendedProperties have been removed (but <code>setProperties(Properties)</code> methods are still here). All occurences of the org.apache.commons.collections.ExtendedProperties class in the runtime internal initialization API have been replaced by org.apache.velocity.util.ExtProperties.</li>
<li>the macros are now using a 'call by sharing' convention (which means that all arguments are evaluated once at start, and that the macro receives a copy of the reference to each argument).</li>
<li>the <code>UberspectLoggable</code> interface has been removed.</li>
-<li>the <code>directive.if.tostring.nullcheck</code> configuration property has been superseded by the <code>directive.if.emptycheck</code> property.</li>
+<li>the <code>directive.if.tostring.nullcheck</code> configuration property has been superseded by the <code>directive.if.emptycheck</code> property, which defaults to true. It means that all empty objects (strings and collections) as long as zero numbers, do evaluate to false (see the complete <a href="configuration.html#if-directive">boolean context evaluation</a> rules.). You may want to set <code>directive.if.emptycheck</code> to false to maximize backward compatibility with 1.x.</li>
</ul>
<h3 id="vtl-changes">VTL Changes:<a class="headerlink" href="#vtl-changes" title="Permanent link">¶</a></h3>
<ul>
@@ -267,6 +268,7 @@ space.gobbling = bc
<li>method arguments can be arithmetic expressions</li>
<li>method arguments are now converted as needed between all main basic Java standard types (booleans, numbers and strings). If you want to revert to the 1.x behavior, set the property <code>runtime.conversion.handler = none</code>.</li>
<li>space gobbling (to control the indentation of generated code) is now configurable via the <code>space.gobbing</code> configuration key, which can take the following values: <code>none</code>, <code>bc</code> (aka. backward compatible), <code>lines</code> and <code>structured</code>. See the related documentation section for details. To maximize backward compatibility with 1.x, set it to <code>bc</code>.</li>
+<li>The #foreach predefined references <code>$velocityCount</code> and <code>$velocityHasNext</code> have been removed. Use <code>$foreach.count</code> (1-based), <code>$foreach.index</code> (0-based) and <code>foreach.hasNext()</code>.</li>
</ul>
<h3 id="dependency-changes">Dependency changes:<a class="headerlink" href="#dependency-changes" title="Permanent link">¶</a></h3>
<ul>