[Jakarta-velocity Wiki] Update of "Velocity15ReleaseNotes" by WillGlassHusain

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Jakarta-velocity Wiki" for change notification.

The following page has been changed by WillGlassHusain:
http://wiki.apache.org/jakarta-velocity/Velocity15ReleaseNotes

The comment on the change is:
added lots of detail, mostly based on changes.xml

------------------------------------------------------------------------------
  == Release Notes and Changes for the Velocity 1.5 release ==
+ 
+ This release is a drop-in replacement for earlier versions of Velocity.  No changes to your application should be required.  The only exception is that several of the dependent JAR libraries have been upgraded, see the section "Dependency Notes", and a requirement for Commons Lang has been added.
  
  === Bug Fixes ===
  
+ There have been many, many bugs fixed.  Check the ChangeLog and [http://issues.apache.org/jira/browse/VELOCITY JIRA] for details  Some of the most important:
+ 
+  * Velocity can now be compiled with JDK 1.5 due to removal of "enum" variable.
+  * Memory leaks in DatasourceResourceLoader have been fixed
+  * #stop now works properly
   * Velocity singleton and engine will attempt to auto-init() when reasonable and possible instead of throwing NPEs when used without calling init() first.
+  * Anakia generates consistent line endings on Windows platforms.
+  * Fixed error in which Velocity would complain if the template ended with "##".
  
  === VTL Enhancements ===
  
-  * VTL now supports float and double variable references for #if and #set
+  * VTL now has complete support for decimals and all number types.  Decimals can be used in mathematical expressions, compared, and set with #set. 
-  * VTL can create Map objects
+  * VTL can create Map objects with #set
+  * new VTL string concatenation operator +
+  * When comparing objects with ==, if objects are different classes with call toString() and compare string representations.
   * Line breaks are allowed in directive calls, macro calls, method calls, and string literals
+  * Macros now accept spaces or commas in separating arguments
+  * Directives can now be delimited with curly braces, for example #if($condition)something#{else}otherthing#{end}.   
  
  === Velocity Enhancements ===
  
+ There are many big and small improvements to the Velocity functionality and API.
+ 
   * Much improved logging facilities, making Velocity a better citizen when integrated into other projects
   * Log messages cleaned up
-  * suport for JDK 1.4 logging
+  * Suport for JDK 1.4 logging
-  * A number of new EventHandler facilities
+  * Error messages now include template name, line and column number
+  * New IncludeEventHandler allows modification of #parse and #include behavior
+  * A number of specific event handler implementations are included, including several that escape HTML/XML entities.
   * URL resource loader for loading Templates right off the Web
+  * Anakia can now be loaded with custom content from XML file
+  * #set statements can be used to set a reference to null.  Similarly, #foreach will properly iterate through a collection containing one or more nulls.
+  * You can now deploy the Velocity jar file in the container classpath while keeping your application in a webapp classpath.  The ClasspathResourceLoader and other modules that use the ClassLoader now search in the current thread's ContextClassLoader before the System ClassLoader.  
+  * FileResourceLoader now accepts absolute paths (when configured to accept them).
+  * The default resource cache implementation now has an upper bound on cache size.
  
+ === Dependency Notes ===
+ 
+  * Requires JRE 1.3 to run, JDK 1.4 to compile.
+  * Upgraded to Commons Collection 3.1
+  * Upgraded to JDom 1.0
+  * Added Commons Lang 2.1 
+  * Requires JavaCC 3.2+ to generate new syntax files
+ 
+ === Other Notes ===
+ 
+  * The documentation has been significantly improved.  Please note that many but not all new beta features are written up.
+  * VelocityServlet is now officially deprecated.  Please use VelocityViewServlet from the Velocity Tools subproject instead. 
+  * VelocityFormatter is also deprecated.  Please use the various formatting tools in the Velocity Tools subproject.
+  * An optional Maven build is now available.  Please note the official build process uses ant.
+ 

---------------------------------------------------------------------
To unsubscribe, e-mail: velocity-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: velocity-dev-help@jakarta.apache.org