[Melati-announce] announce Melati 0.54

[Tim J. <ti...@ho...>]

Melati 0.54 is now available for download from http://melati.org

Version 0.54 introduces the following enhancements  (check the release notes
for full details):

o - support for Webmacro 0.97. Previous versions of webmacro are no longer
supported.
o - support for Velocity 1.1


WebMacro 0.97

Cleaning up. We have removed all 'hacked' webmacro classes from Melati. If
you have any org.webmacro.* classes hanging arround, please ensure you
delete them.

FastWriter. FastWriter is now constructed with a Broker. So, you will need
to replace any construction (eg):
MelatiFastWriter(OutputStream output, String encoding) with
MelatiFastWriter(Broker broker, OutputStream output, String encoding)

Exception Handling in Templates. Melati sets a PropagateExceptionHandler by
default (forcing a logon page on encountering a AccessPoemException). If you
want to use a PassbackExceptionHandler, you must set it in your template:
$melati.setVariableExceptionHandler($melati.PassbackVariableExceptionHandler
). Please ensure you check your Templates.


Velocity

Melati now supports Velocity 1.1.

At this stage, we don't ship any Velocity specific templates, instead we
translate the webmacro templates 'on the fly'. To do this, we override the
Velocity file.resource.loader.class with our own
org.melati.template.velocity.WebMacroFileResourceLoader. If a .vm template
with the correct name is found it will be used, otherwise, the .wm template
will be loaded and translated.

The template path for Velocity is set in
org.melati.MelatiServlet.properties. It may be a good idea to do this for
WebMacro as well, but it wasn't obvious how to do this, so it has been left
for the time being.


Please can everyone working on preproduction sites make use of this release
so that it can be properly tested.  Also, I would recommend that production
sites migrate as I believe that 0.97 webmacro fixes memory 'leak' problems
that may be encountered on production systems.

Thanks

Tim Joyce