fixing a variety of errors in javadoc generation (syntax errors, misnamed params, etc.)