-- added javadoc descriptions to methods

-- help define what the methods test