Add some Java doc and Smeed's promise