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: filled out more details ------------------------------------------------------------------------------ == 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. + 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 and a requirement for Commons Lang has been added. See the section "Dependency Notes" for more details. + + You may also want to consult the Velocity RoadMap for details on future direction. === 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 + * Memory leaks in DatasourceResourceLoader have been fixed. - * #stop now works properly + * #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 === + The Velocity Template Language (VTL) has been improved to be easier to use. Significant enhancements include new data types, new operators, improvements to the behavior of "==", and minor syntax improvements. + * 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 with #set + * VTL can create Map objects with #set. - * new VTL string concatenation operator + + * new VTL string concatenation operator "+". - * When comparing objects with ==, if objects are different classes with call toString() and compare string representations. + * When comparing objects with "==" will compare String representations if objects are of different classes. - * Line breaks are allowed in directive calls, macro calls, method calls, and string literals + * Line breaks are allowed in directive calls, macro calls, method calls, and string literals. - * Macros now accept spaces or commas in separating arguments + * 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. + There are many big and small improvements to the functionality of the Velocity engine. Many of these improvements are aimed at improving error reporting, simplifying integration into larger applications, and simplifying configuration. * Much improved logging facilities, making Velocity a better citizen when integrated into other projects - * Log messages cleaned up - * Suport for JDK 1.4 logging + * The log messages have been cleaned up. + * New suport for JDK 1.4 logging is included. - * Error messages now include template name, line and column number + * The error messages now include template name, line and column number. - * New IncludeEventHandler allows modification of #parse and #include behavior + * 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 + * A URL resource loader is included for loading Templates right off the Web. - * Anakia can now be loaded with custom content from XML file + * 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. + * You can now deploy the Velocity jar file in the container classpath while keeping your application in a webapp classpath. * 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 === + If you are upgrading Velocity in an existing application, be sure to check that you have the copies of the correct versions of dependendent jar files. + * 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 + * Added Commons Lang 2.1 dependency * Requires JavaCC 3.2+ to generate new syntax files + + === Known Issues === + + There are a few known bugs and issues to be addressed before a Velocity 1.5 release. See [http://issues.apache.org/jira/browse/VELOCITY JIRA] for details. + + * The new Event Handlers needed to be documented. + * There remain various subtle escaping bugs + * DVSL is incompatible with Velocity 1.5 + * Macros cannot be defined in one file and included with #parse in another. See MacroIssues for more information. === 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. + * An optional Maven build is now available. However, ant remains the primary build tool. --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
