Updated Tests.
Much more clear error message on IllegalArgumentException
Javadoc updated to include some examples