added some moar javadocs