[PLAT-4606] Improved java doc.
[PLAT-4802] Conventions for futures corrected.