Jar: Documentation and hardening

Need to javadoc every package and every public and protected method.

Also need to harden the code, and doing this while documenting it is a good way of doing it as the contract of each method is at the front of the mind while doing so.