Update the javadocs to make things a little clearer.