Updated warning section. Added Java docs and examples.