Author: cbrisson
Date: Mon Aug 28 08:49:36 2017
New Revision: 1806413
URL: http://svn.apache.org/viewvc?rev=1806413&view=rev
Log:
[engine] Additions to the upgrading page
Modified:
velocity/site/cms/trunk/content/engine/2.0/upgrading.mdtext
velocity/site/cms/trunk/content/engine/devel/upgrading.mdtext
Modified: velocity/site/cms/trunk/content/engine/2.0/upgrading.mdtext
URL:
http://svn.apache.org/viewvc/velocity/site/cms/trunk/content/engine/2.0/upgrading.mdtext?rev=1806413&r1=1806412&r2=1806413&view=diff
==============================================================================
--- velocity/site/cms/trunk/content/engine/2.0/upgrading.mdtext (original)
+++ velocity/site/cms/trunk/content/engine/2.0/upgrading.mdtext Mon Aug 28
08:49:36 2017
@@ -18,6 +18,7 @@ For busy people: To maximize backward co
runtime.conversion.handler = none
space.gobbling = bc
+ directive.if.emptycheck = false
and check the [Dependency changes](#dependencies-changes) below.
@@ -38,7 +39,7 @@ Read below for futher details.
+ Initialization methods in Velocity and VelocityEngine taking an
ExtendedProperties have been removed (but `setProperties(Properties)` 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.
+ 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).
+ the `UberspectLoggable` interface has been removed.
-+ the `directive.if.tostring.nullcheck` configuration property has been
superseded by the `directive.if.emptycheck` property.
++ the `directive.if.tostring.nullcheck` configuration property has been
superseded by the `directive.if.emptycheck` 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 [boolean context
evaluation](configuration.html#if-directive) rules.). You may want to set
`directive.if.emptycheck` to false to maximize backward compatibility with 1.x.
### VTL Changes:
@@ -46,6 +47,7 @@ Read below for futher details.
+ method arguments can be arithmetic expressions
+ 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 `runtime.conversion.handler = none`.
+ space gobbling (to control the indentation of generated code) is now
configurable via the `space.gobbing` configuration key, which can take the
following values: `none`, `bc` (aka. backward compatible), `lines` and
`structured`. See the related documentation section for details. To maximize
backward compatibility with 1.x, set it to `bc`.
++ The #foreach predefined references `$velocityCount` and `$velocityHasNext`
have been removed. Use `$foreach.count` (1-based), `$foreach.index` (0-based)
and `foreach.hasNext()`.
### Dependency changes:
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=1806413&r1=1806412&r2=1806413&view=diff
==============================================================================
--- velocity/site/cms/trunk/content/engine/devel/upgrading.mdtext (original)
+++ velocity/site/cms/trunk/content/engine/devel/upgrading.mdtext Mon Aug 28
08:49:36 2017
@@ -18,6 +18,7 @@ For busy people: To maximize backward co
runtime.conversion.handler = none
space.gobbling = bc
+ directive.if.emptycheck = false
and check the [Dependency changes](#dependencies-changes) below.
@@ -38,7 +39,7 @@ Read below for futher details.
+ Initialization methods in Velocity and VelocityEngine taking an
ExtendedProperties have been removed (but `setProperties(Properties)` 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.
+ 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).
+ the `UberspectLoggable` interface has been removed.
-+ the `directive.if.tostring.nullcheck` configuration property has been
superseded by the `directive.if.emptycheck` property.
++ the `directive.if.tostring.nullcheck` configuration property has been
superseded by the `directive.if.emptycheck` 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 [boolean context
evaluation](configuration.html#if-directive) rules.). You may want to set
`directive.if.emptycheck` to false to maximize backward compatibility with 1.x.
### VTL Changes:
@@ -46,6 +47,7 @@ Read below for futher details.
+ method arguments can be arithmetic expressions
+ 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 `runtime.conversion.handler = none`.
+ space gobbling (to control the indentation of generated code) is now
configurable via the `space.gobbing` configuration key, which can take the
following values: `none`, `bc` (aka. backward compatible), `lines` and
`structured`. See the related documentation section for details. To maximize
backward compatibility with 1.x, set it to `bc`.
++ The #foreach predefined references `$velocityCount` and `$velocityHasNext`
have been removed. Use `$foreach.count` (1-based), `$foreach.index` (0-based)
and `foreach.hasNext()`.
### Dependency changes:
