TEZ-1416. tez-api project javadoc/annotations review and clean up (bikas)