Add some Javadocs and remove 'auto inserted' code stubs
The Javadoc text must appear above the @author tag
Simple fixes to Javadoc errors or omissions. (or just text rewrite for clarity).