(I'm trying to post from this account to avoid the Microsoft
bugs. [EMAIL PROTECTED] == [EMAIL PROTECTED])
A couple of things:
I think that velocity.log should be mentioned near the
begining of both the developer's and user's documentation.
(Now, it is near the end.) Also, I think it should be
in the javadoc-comments in the examples. Why? Because
if you make a simple typo in your template, the only useful
information will be in the log file. So, it is very
important. However, I think a lot of engineers are going
to just glance at the examples near the start of the
documentation, and start to use Velocity. Or, they will
cut-and-paste the examples. In either case, knowledge of
the log file is important.
Also, I put a $2d6 in a template, which is illegal. (It
would have made sense with a custom context.) Anyway,
the exception from Velocity talked about not finding a
template. The second exception back had the useful information
about the illegal template. By the time I saw this, however,
I had already wasted some time. I assume that the illegal
template exception gets caught and a 'can not find template'
exception gets thrown later, and this is confusing. Finally,
if all variables must start with a $, why not allow numbers
to start off a variable name? Why isn't $2d6 legal?
At home I have 0.72 (I think) installed, so these issues
may be gone by now.
I integrated Velocity into a program, and instead of printing
out a template, it printed out:
Woo! No ICD!
that behavior was strange enough so that I didn't even look
at the velocity.log, and I'm at work now.
BTW: I like the idea of a template returning the an error
instead of the text of the template, rather than throwing
an exception with the text message in a log file. It would
have been better to see the illegal IDENTIFIER message
instead of the template, rather than figure out why it returned
NULL, check the log file, look at the second to last message,
etc.
I can provide reproducable test cases for this stuff, if needed.
Joshua Levy
__________________________________________________
Do You Yahoo!?
Get email at your own domain with Yahoo! Mail.
http://personal.mail.yahoo.com/?.refer=text
