added class documentation and 'make javadoc' target