Reflect recent changes to Java API documentation

Adjust documentation to reflect Java API changes (interfaces instead of classes)
we enforce inside the main code to always use brackets around statements. (I think its the famous `goto fail;`).
I think its better to have them in the documentation as well (to educate users that might become committers)