added more prose about input/output format and links to their javadoc