javadoc
adding example output/input formats