Author: cbrisson
Date: Mon Dec 16 17:05:16 2019
New Revision: 1871670
URL: http://svn.apache.org/viewvc?rev=1871670&view=rev
Log:
[site/engine] Update 2.2 site for RC2 changes
Modified:
velocity/site/cms/trunk/content/engine/2.2/build.mdtext
velocity/site/cms/trunk/content/engine/2.2/configuration-property-changes-in-2.1.mdtext
velocity/site/cms/trunk/content/engine/2.2/developer-guide.mdtext
velocity/site/cms/trunk/content/engine/2.2/upgrading.mdtext
velocity/site/cms/trunk/content/engine/devel/build.mdtext
velocity/site/cms/trunk/content/engine/devel/developer-guide.mdtext
velocity/site/cms/trunk/content/engine/devel/upgrading.mdtext
Modified: velocity/site/cms/trunk/content/engine/2.2/build.mdtext
URL:
http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/engine/2.2/build.mdtext?rev=1871670&r1=1871669&r2=1871670&view=diff
==============================================================================
--- velocity/site/cms/trunk/content/engine/2.2/build.mdtext (original)
+++ velocity/site/cms/trunk/content/engine/2.2/build.mdtext Mon Dec 16 17:05:16
2019
@@ -2,7 +2,7 @@ Title: Apache Velocity Engine - Building
## Installation
-Velocity runs on a variety of platforms that have installed the Java Virtual
Machine. A Java Development Kit version 1.7+ is required to compile Velocity
from its source code (as it is to run it).
+Velocity runs on a variety of platforms that have installed the Java Virtual
Machine. A Java Development Kit version 1.8+ is required to compile Velocity
from its source code (as it is to run it).
Everything required to build Velocity comes with the distribution, which can
be obtained from [Subversion](http://svn.apache.org/repos/asf/velocity/engine/)
or from the [main distribution](/download.cgi#engine). However, you will need
to install [Maven](http://maven.apache.org/) to build the Velocity sources.
@@ -23,7 +23,9 @@ In each case below, it is assumed that y
Executing this script will create a **target** directory within the velocity
directory. Each subdirectory containing a module of Velocity will contain a
"target" directory too, containing all built jars.
-Refer to Maven documentation for all phases you can invoke.
+After a successful build with the above command, your Velocity build will be
available in your local Maven repository.
+
+Refer to Maven documentation for alternate commands you can invoke.
If you find a problem, do not hesitate to ask the Velocity community
-via our [mail lists](/contact.html).
+via our [email lists](/contact.html).
Modified:
velocity/site/cms/trunk/content/engine/2.2/configuration-property-changes-in-2.1.mdtext
URL:
http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/engine/2.2/configuration-property-changes-in-2.1.mdtext?rev=1871670&r1=1871669&r2=1871670&view=diff
==============================================================================
---
velocity/site/cms/trunk/content/engine/2.2/configuration-property-changes-in-2.1.mdtext
(original)
+++
velocity/site/cms/trunk/content/engine/2.2/configuration-property-changes-in-2.1.mdtext
Mon Dec 16 17:05:16 2019
@@ -6,7 +6,7 @@ Velocity Engine configuration property n
### Changes Summary
-2.0 property name | 2.1 property name | Property purpose
+2.0 property name | 2.1+ property name | Property purpose
------------------|------------------ |-----------------
runtime.log.instance | *unchanged* | org.slf4j.Logger instance
runtime.log.name | *unchanged* | org.slf4j.Logger name
Modified: velocity/site/cms/trunk/content/engine/2.2/developer-guide.mdtext
URL:
http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/engine/2.2/developer-guide.mdtext?rev=1871670&r1=1871669&r2=1871670&view=diff
==============================================================================
--- velocity/site/cms/trunk/content/engine/2.2/developer-guide.mdtext (original)
+++ velocity/site/cms/trunk/content/engine/2.2/developer-guide.mdtext Mon Dec
16 17:05:16 2019
@@ -920,6 +920,7 @@ All event handler interfaces available i
> When a reference has an alternate value provided, as in `${foo.bar|'foo'}`,
> whenever `$foo.bar` is invalid, the invalid reference handler will only be
> called if the alternate value is invalid.
>
> There are three special cases where invalid reference events aren't
> triggered:
+>
> + When the reference is a quiet reference (this behavior can be reverted to
> the 1.7 behavior using the backward compatibility flag
> `event_handler.invalid_references.quiet = true`).
> + when the reference is present in the context but has a null value, or the
> called method returned null (this behavior can be reverted to the 1.7
> behavior using the backward compatibility flag
> `event_handler.invalid_references.null = true`).
> + when the reference is just tested for validity in an `#if()` statement
> (this behavior can be reverted to the 1.7 behavior using the backward
> compatibility flag `event_handler.invalid_references.tested = true`).
@@ -1085,8 +1086,10 @@ Since Velocity 2.0, besides the default
<th>Short</th>
<th>Integer</th>
<th>Long</th>
+ <th>BigInteger</th>
<th>Float</th>
<th>Double</th>
+ <th>BigDecimal</th>
<th>Number</th>
<th>String</th>
<th>Object</th>
@@ -1104,6 +1107,8 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
</tr>
@@ -1121,18 +1126,22 @@ Since Velocity 2.0, besides the default
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
+ <td><span class="none">none</span></td>
+ <td><span class="none">none</span></td>
</tr>
<tr>
<th>byte</th>
<td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
- <td><span class="implicit">implicit</span></td>
+ <td><span class="strict">strict</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="none">none</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
@@ -1149,6 +1158,8 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
</tr>
@@ -1164,6 +1175,8 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
</tr>
@@ -1179,6 +1192,8 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
</tr>
@@ -1190,10 +1205,12 @@ Since Velocity 2.0, besides the default
<td><span class="implicit">implicit</span></td>
<td><span class="implicit">implicit</span></td>
<td><span class="implicit">implicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="implicit">implicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
</tr>
@@ -1205,10 +1222,12 @@ Since Velocity 2.0, besides the default
<td><span class="implicit">implicit</span></td>
<td><span class="implicit">implicit</span></td>
<td><span class="implicit">implicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="implicit">implicit</span></td>
<td><span class="implicit">implicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
</tr>
@@ -1224,6 +1243,8 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="strict">strict</span></td>
</tr>
@@ -1240,6 +1261,8 @@ Since Velocity 2.0, besides the default
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
+ <td><span class="none">none</span></td>
+ <td><span class="none">none</span></td>
<td><span class="strict">strict</span></td>
</tr>
<tr>
@@ -1254,6 +1277,8 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="strict">strict</span></td>
</tr>
@@ -1261,7 +1286,7 @@ Since Velocity 2.0, besides the default
<th>Short</th>
<td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
- <td><span class="none">none</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="strict">strict</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
@@ -1269,6 +1294,8 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="strict">strict</span></td>
</tr>
@@ -1276,7 +1303,7 @@ Since Velocity 2.0, besides the default
<th>Integer</th>
<td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
- <td><span class="none">none</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="strict">strict</span></td>
<td><span class="explicit">explicit</span></td>
@@ -1284,6 +1311,8 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="strict">strict</span></td>
</tr>
@@ -1291,7 +1320,7 @@ Since Velocity 2.0, besides the default
<th>Long</th>
<td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
- <td><span class="none">none</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="strict">strict</span></td>
@@ -1299,14 +1328,34 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="strict">strict</span></td>
</tr>
<tr>
- <th>Float</th>
+ <th>BigInteger</th>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="strict">strict</span></td>
+ <td><span class="none">none</span></td>
+ <td><span class="none">none</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="none">none</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="none">none</span></td>
+ <td><span class="strict">strict</span></td>
+ </tr>
+ <tr>
+ <th>Float</th>
<td><span class="none">none</span></td>
+ <td><span class="none">none</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
@@ -1314,6 +1363,7 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="strict">strict</span></td>
</tr>
@@ -1321,7 +1371,8 @@ Since Velocity 2.0, besides the default
<th>Double</th>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
- <td><span class="none">none</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
@@ -1329,6 +1380,24 @@ Since Velocity 2.0, besides the default
<td><span class="strict">strict</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="none">none</span></td>
+ <td><span class="strict">strict</span></td>
+ </tr>
+ <tr>
+ <th>BigDecimal</th>
+ <td><span class="none">none</span></td>
+ <td><span class="none">none</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="strict">strict</span></td>
+ <td><span class="none">none</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="strict">strict</span></td>
</tr>
@@ -1343,6 +1412,8 @@ Since Velocity 2.0, besides the default
<td><span class="strict">strict</span></td>
<td><span class="strict">strict</span></td>
<td><span class="strict">strict</span></td>
+ <td><span class="strict">strict</span></td>
+ <td><span class="strict">strict</span></td>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
<td><span class="strict">strict</span></td>
@@ -1358,6 +1429,8 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="strict">strict</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="strict">strict</span></td>
@@ -1367,6 +1440,8 @@ Since Velocity 2.0, besides the default
<td><span class="strict">strict</span></td>
<td><span class="strict">strict</span></td>
<td><span class="strict">strict</span></td>
+ <td><span class="strict">strict</span></td>
+ <td><span class="strict">strict</span></td>
<td><span class="strict">strict</span></td>
<td><span class="strict">strict</span></td>
<td><span class="strict">strict</span></td>
Modified: velocity/site/cms/trunk/content/engine/2.2/upgrading.mdtext
URL:
http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/engine/2.2/upgrading.mdtext?rev=1871670&r1=1871669&r2=1871670&view=diff
==============================================================================
--- velocity/site/cms/trunk/content/engine/2.2/upgrading.mdtext (original)
+++ velocity/site/cms/trunk/content/engine/2.2/upgrading.mdtext Mon Dec 16
17:05:16 2019
@@ -44,6 +44,7 @@ Also, please note that since version 2.1
+ The references with alternate values like `${foo|'foo'}` won't trigger any
invalid reference event if their alternate value is valid.
+ New [`runtime.log.track_location`](configuration.html#logging) debugging
configuration flag (defaults to false). When true, logs VTL stacktrace on
errors and populate slf4j template location MDC tags.
+ New 1.7.x backward compatibility configuration flags for event handlers, see
above section.
++ When active, the conversion handler will automatcally convert BigInteger and
BigDecimal values towards/from expected method arguments types, see [method
arguments conversion](developer-guide.html#method-arguments-conversions).
### VTL Changes
Modified: velocity/site/cms/trunk/content/engine/devel/build.mdtext
URL:
http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/engine/devel/build.mdtext?rev=1871670&r1=1871669&r2=1871670&view=diff
==============================================================================
--- velocity/site/cms/trunk/content/engine/devel/build.mdtext (original)
+++ velocity/site/cms/trunk/content/engine/devel/build.mdtext Mon Dec 16
17:05:16 2019
@@ -2,7 +2,7 @@ Title: Apache Velocity Engine - Building
## Installation
-Velocity runs on a variety of platforms that have installed the Java Virtual
Machine. A Java Development Kit version 1.7+ is required to compile Velocity
from its source code (as it is to run it).
+Velocity runs on a variety of platforms that have installed the Java Virtual
Machine. A Java Development Kit version 1.8+ is required to compile Velocity
from its source code (as it is to run it).
Everything required to build Velocity comes with the distribution, which can
be obtained from [Subversion](http://svn.apache.org/repos/asf/velocity/engine/)
or from the [main distribution](/download.cgi#engine). However, you will need
to install [Maven](http://maven.apache.org/) to build the Velocity sources.
@@ -23,7 +23,9 @@ In each case below, it is assumed that y
Executing this script will create a **target** directory within the velocity
directory. Each subdirectory containing a module of Velocity will contain a
"target" directory too, containing all built jars.
-Refer to Maven documentation for all phases you can invoke.
+After a successful build with the above command, your Velocity build will be
available in your local Maven repository.
+
+Refer to Maven documentation for alternate commands you can invoke.
If you find a problem, do not hesitate to ask the Velocity community
-via our [mail lists](/contact.html).
+via our [email lists](/contact.html).
Modified: velocity/site/cms/trunk/content/engine/devel/developer-guide.mdtext
URL:
http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/engine/devel/developer-guide.mdtext?rev=1871670&r1=1871669&r2=1871670&view=diff
==============================================================================
--- velocity/site/cms/trunk/content/engine/devel/developer-guide.mdtext
(original)
+++ velocity/site/cms/trunk/content/engine/devel/developer-guide.mdtext Mon Dec
16 17:05:16 2019
@@ -920,6 +920,7 @@ All event handler interfaces available i
> When a reference has an alternate value provided, as in `${foo.bar|'foo'}`,
> whenever `$foo.bar` is invalid, the invalid reference handler will only be
> called if the alternate value is invalid.
>
> There are three special cases where invalid reference events aren't
> triggered:
+>
> + When the reference is a quiet reference (this behavior can be reverted to
> the 1.7 behavior using the backward compatibility flag
> `event_handler.invalid_references.quiet = true`).
> + when the reference is present in the context but has a null value, or the
> called method returned null (this behavior can be reverted to the 1.7
> behavior using the backward compatibility flag
> `event_handler.invalid_references.null = true`).
> + when the reference is just tested for validity in an `#if()` statement
> (this behavior can be reverted to the 1.7 behavior using the backward
> compatibility flag `event_handler.invalid_references.tested = true`).
@@ -1085,8 +1086,10 @@ Since Velocity 2.0, besides the default
<th>Short</th>
<th>Integer</th>
<th>Long</th>
+ <th>BigInteger</th>
<th>Float</th>
<th>Double</th>
+ <th>BigDecimal</th>
<th>Number</th>
<th>String</th>
<th>Object</th>
@@ -1104,6 +1107,8 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
</tr>
@@ -1121,18 +1126,22 @@ Since Velocity 2.0, besides the default
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
+ <td><span class="none">none</span></td>
+ <td><span class="none">none</span></td>
</tr>
<tr>
<th>byte</th>
<td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
- <td><span class="implicit">implicit</span></td>
+ <td><span class="strict">strict</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="none">none</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
@@ -1149,6 +1158,8 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
</tr>
@@ -1164,6 +1175,8 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
</tr>
@@ -1179,6 +1192,8 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
</tr>
@@ -1190,10 +1205,12 @@ Since Velocity 2.0, besides the default
<td><span class="implicit">implicit</span></td>
<td><span class="implicit">implicit</span></td>
<td><span class="implicit">implicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="implicit">implicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
</tr>
@@ -1205,10 +1222,12 @@ Since Velocity 2.0, besides the default
<td><span class="implicit">implicit</span></td>
<td><span class="implicit">implicit</span></td>
<td><span class="implicit">implicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="implicit">implicit</span></td>
<td><span class="implicit">implicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
</tr>
@@ -1224,6 +1243,8 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="strict">strict</span></td>
</tr>
@@ -1240,6 +1261,8 @@ Since Velocity 2.0, besides the default
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
+ <td><span class="none">none</span></td>
+ <td><span class="none">none</span></td>
<td><span class="strict">strict</span></td>
</tr>
<tr>
@@ -1254,6 +1277,8 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="strict">strict</span></td>
</tr>
@@ -1261,7 +1286,7 @@ Since Velocity 2.0, besides the default
<th>Short</th>
<td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
- <td><span class="none">none</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="strict">strict</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
@@ -1269,6 +1294,8 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="strict">strict</span></td>
</tr>
@@ -1276,7 +1303,7 @@ Since Velocity 2.0, besides the default
<th>Integer</th>
<td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
- <td><span class="none">none</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="strict">strict</span></td>
<td><span class="explicit">explicit</span></td>
@@ -1284,6 +1311,8 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="strict">strict</span></td>
</tr>
@@ -1291,7 +1320,7 @@ Since Velocity 2.0, besides the default
<th>Long</th>
<td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
- <td><span class="none">none</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="strict">strict</span></td>
@@ -1299,14 +1328,34 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="strict">strict</span></td>
</tr>
<tr>
+ <th>BigInteger</th>
+ <td><span class="none">none</span></td>
+ <td><span class="none">none</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="strict">strict</span></td>
+ <td><span class="none">none</span></td>
+ <td><span class="none">none</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="none">none</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="none">none</span></td>
+ <td><span class="strict">strict</span></td>
+ </tr>
+ <tr>
<th>Float</th>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
- <td><span class="none">none</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
@@ -1314,6 +1363,7 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="strict">strict</span></td>
</tr>
@@ -1321,13 +1371,32 @@ Since Velocity 2.0, besides the default
<th>Double</th>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
- <td><span class="none">none</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="strict">strict</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="none">none</span></td>
<td><span class="strict">strict</span></td>
+ </tr>
+ <tr>
+ <th>BigDecimal</th>
+ <td><span class="none">none</span></td>
+ <td><span class="none">none</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="strict">strict</span></td>
+ <td><span class="none">none</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="none">none</span></td>
<td><span class="strict">strict</span></td>
@@ -1343,6 +1412,8 @@ Since Velocity 2.0, besides the default
<td><span class="strict">strict</span></td>
<td><span class="strict">strict</span></td>
<td><span class="strict">strict</span></td>
+ <td><span class="strict">strict</span></td>
+ <td><span class="strict">strict</span></td>
<td><span class="none">none</span></td>
<td><span class="none">none</span></td>
<td><span class="strict">strict</span></td>
@@ -1358,6 +1429,8 @@ Since Velocity 2.0, besides the default
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
+ <td><span class="explicit">explicit</span></td>
<td><span class="strict">strict</span></td>
<td><span class="explicit">explicit</span></td>
<td><span class="strict">strict</span></td>
@@ -1367,6 +1440,8 @@ Since Velocity 2.0, besides the default
<td><span class="strict">strict</span></td>
<td><span class="strict">strict</span></td>
<td><span class="strict">strict</span></td>
+ <td><span class="strict">strict</span></td>
+ <td><span class="strict">strict</span></td>
<td><span class="strict">strict</span></td>
<td><span class="strict">strict</span></td>
<td><span class="strict">strict</span></td>
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=1871670&r1=1871669&r2=1871670&view=diff
==============================================================================
--- velocity/site/cms/trunk/content/engine/devel/upgrading.mdtext (original)
+++ velocity/site/cms/trunk/content/engine/devel/upgrading.mdtext Mon Dec 16
17:05:16 2019
@@ -44,6 +44,7 @@ Also, please note that since version 2.1
+ The references with alternate values like `${foo|'foo'}` won't trigger any
invalid reference event if their alternate value is valid.
+ New [`runtime.log.track_location`](configuration.html#logging) debugging
configuration flag (defaults to false). When true, logs VTL stacktrace on
errors and populate slf4j template location MDC tags.
+ New 1.7.x backward compatibility configuration flags for event handlers, see
above section.
++ When active, the conversion handler will automatcally convert BigInteger and
BigDecimal values towards/from expected method arguments types, see [method
arguments conversion](developer-guide.html#method-arguments-conversions).
### VTL Changes