Re: Issues w/ CSS validator documentation and installation

Hello all,

I've sent some patches related to those problem to the CSS Validator 
commiters. Unfortunately time is a scarce resource for everybody :)

Damien

Jens Meiert wrote:
> 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
>

Received on Monday, 18 August 2008 21:43:33 UTC