improved javadoc and cleaned old (= pre 1.5) stuff up