[commit] Important, please read: regard tool

[Vincent Hardy <vi...@eng.sun.com>]

Hello,

The new build.xml also includes a target for the regard tool. This 
tool can run regression testing for you. The idea is that it manages
a directory of svg files and will look for differences in the 
way Batik renders them, which the tool will flag as regressions.

Therefore, I think it would be good that everyone uses that tool as
follows:

a. When you do an update, run regard to create new reference images.
b. Before doing a commit, or during your modifs, run regard to 
   check that regressions are not creeping it. Regard can compare
   the reference image with newly generated images. If there are 
   differences, they will be visible immediately.
c. Commit when you know there are no regressions on the test 
   files.

One good idea would be to put all the BE tests we pass in the reference
directory, but this is something still on my (volunteer?) todo list. 
Before we have an agreed upon list, I still encourage everybody to 
use the tool.

There is a documenatation on how to use regard in the xdocs directory.

Cheers & Happy Thanksgiving.
V.