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