Reuven,
I agree this is confusing. The graphic designer folks, with the least desire to debug scripts, are given misleading, or seemingly incorrect output from the adp templates. A lot of time you get no error at all generated. As Lars has pointed out, the template parser is little more than an appender. His trick of using compile.tcl looks like a great tool for debugging.
