Javadoc improvements

Outdated, closing.