adapted javadoc to use <code> tags, corrected javadoc errors (using Netbeans 8.0 code inspector)