Retouched quite a bit of javadoc. Also made a new ant target called 'javadoc' for compiling documentation to the folder doc/api