Various javadoc fixes.
Document the promise operations, and clean some other stuff up along the way.
Woops.