Document known issues. #183
Fix Javadoc.