Issues w/ CSS validator documentation and installation

Dear validator team,


setting up a local instance of the CSS validator (based on CVS co on
August 7) I noticed a few more or less severe issues. As I am not
particularly experienced w/ neither Tomcat nor Java, and as I did not
document all problems I came across anyway I'm keeping this short
though.

* Documentation (aka setup instructions [1]) is generally thin and
vague, at best, and per se it really doesn't suffice to get the
validator running.

* <IndexGenerator.java> contains a wrong path, it should be
"org/w3c/css/index/" instead of "org/w3c/css/css/".

(* <Messages.java> might benefit from a revision as way less code
might be necessary to achieve the desired outcome.)

* There seems to be a general issue w/ "getFile" functions (lots of
"cannot be found" errors), alas, I cannot tell if that is a general
error or something "machine" specific. (It's been necessary to include
fix path refs and to sacrifice pseudo content negotiation to work
around these issues in my case.)

* <build.xml> would benefit from excluding the "build" directory from
being copied (thus slowing down the process); adding "<exclude
name="build/**"/>" should fix that.


I suggest the documentation to be updated and extended and the code to
be checked again. Also, if W3C's CVS trunk must not only contain code
that is tested and working, a note pointing that out might be a good
thing.


Thanks,
 Jens.


[1] http://jigsaw.w3.org/css-validator/DOWNLOAD.html

-- 
Jens Meiert
http://meiert.com/en/

Received on Monday, 18 August 2008 20:28:35 UTC