readme cosmetics
formatting, javadocs