added some informative javadoc in the files
for later reference