miscellaneous javadoc fixes

- added some spacing
- added some class/method descriptions