Added a few extra lines of javadoc to explain certain features and include a bug list