fixed bug #3: added illegal moisture check
generated updated javadoc