The current way the velocity directives work is borked.

Basically, I think they write directly to the response, instead of to the current Velocity controller writer. This means you can get strange sequences of output.

For example if you have something like:

a
  #tag (foo)
b

You get

a
  foo
b

which is what you'd expect (and why noone has discovered this before).

However if you're nesting directives, the output order is wrong, for example this:

#a
  #tag(foo)
#end

produces output like this:

foo
a
end a

not like this:

a
   foo
end a