added javadocs for three classes