update of readme, add some javadoc to tests.