Upgrade the messages on our exceptions to help coders fix their mistakes.
Upgrade the javadoc.