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>
